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HOW TO USE THIS MANUAL 


The CTIX Operating System Manual, Version B, describes the 
commands, system calls, libraries, data files, and device 
interfaces that make up the CTIX Operating System on 
MiniFrame Computer Systems and MightyFrame Computer 
Systems. Only internal-use and unbundled software products are 
excluded. This manual should always be your starting point 
when you need to find the documentation for a CTIX feature 
with which you are unfamiliar. 


The manual consists of a large number of short entries, 
sometimes called “the man pages,” after the command which 
accesses the entries when they are kept online. Each entry 
briefly documents some feature of CTIX. Some features require 
longer documentation than an entry in this manual; such features 
have an entry that outlines the feature and cross-references the 
manual that documents the feature fully. Entries that do not 
refer to other manuals are self-contained and are the final word 
on the features they describe. 


Organization of the manual. The entries are organized into 
seven sections in two volumes: 


Volume L: 
1. Commands and Application Programs. 


Volume 2: 

System Calls. 

Subroutines and Libraries. 
File Formats. 
Miscellaneous Facilities. 
Games. 

Special files. 


NE OUR go bo 


Within each section, entries are alphabetical by title, except for 
an intro entry at the beginning of each section. 


Entry Title Conventions. An entry title looks like this 
example: 


erf(3M) 


los Type 
ection Number 


ame 
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Name is the name of the entry. Section Number indicates the 
section that contains the entry. In this case, the entry is in 
Section 3, which is in Volume 2. Entry Type is only on entries 
that belong to special categories; refer to the section’s intro entry 
for an explanation. In this case, a reference to intro(3) would tell 
you that erf3M) describes functions from the Math Library, 
which the C compiler does not load by default. 


Finding the entry you need. To find out which entry you 
need, refer to the following guides: 


e The Permuted Index. This indexes each significant word 
in each entry’s description. It is useful when you only 
have a general notion what you’re looking for. It is also 
useful when you know the name of the command, 
function, etc., that you are interested in, but there is no 
entry by that name. To simplify its use, a complete 
Permuted Index for both volumes is in each volume. 


e The Table of Contents. This is a simple list of entries, 
by section, together with the entry descriptions. Volume 
1 has a Table of Contents for Section 1. Volume 2 has a 
Table of Contents for Sections 2 through 7. 


e The Table of Related Entries. For Volume 1 only. A 
table of entries organized so that related entries are 
grouped together. 


Section organization. Each section begins with an intro entry, 
which provides important general information for that section. 


Section 1, Commands and Application Programs, describes 
programs intended to be invoked directly by the user or by 
command language procedures, as opposed to subroutines, which 
are intended to be called by the user’s programs. Commands 
generally reside in the directory /bin (for binary programs). 
Some programs also reside in /usr/bin, to save space in /bin. 
These directories are searched automatically by the command 
interpreter called the shell, Commands that were not 
transported from UNIX System V reside in /usr/local/bin; this 
directory is recommended for locally implemented programs. 
Some administrative commands reside in /ete and various other 
places. The /ete directory is searched automatically if you are 
logged in as root; otherwise type out the full path name given 
under SYNOPSIS or change the PATH environment variable to 
include the command’s directory. 


Section 2, System Calls, describes the entries into the CTIX 
kernel, including the C language interfaces. 
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Section 3, Subroutines and Libraries, describes the available 
library functions or subroutines. Their binary versions reside in 
various system libraries in the directories /lib and /usr/lib. See 
tntro(3) for descriptions of these libraries and the files in which 
they are stored. 


Section 4, File Formats, documents the structure of particular 
kinds of files; for example, the format of the output of the link 
editor is given in a.out(4). Excluded are files used by only one 
command (for example, the assembler’s intermediate files). In 
general, the C language struct declarations corresponding to 
these formats can be found in the directories /usr/include and 
/usr /include/sys. 


Section 5, Miscellaneous Facilities, contains a variety of things. 
Included are descriptions of character sets, macro packages, etc. 


Section 6, Games, describes the games and educational programs 
that reside in the directory /usr/games. 


Section 7, Special Files, discusses the characteristics of files that 
actually refer to input/output devices. 


Entry organization. All entries are based on a common 
format, not all of whose parts always appear: 


The NAME part gives the name(s) of the entry and briefly 
states its purpose. 


The SYNOPSIS part summarizes the use of the program 
being described. A few conventions are used, particularly in 
Section 1 (Commands): 


Boldface strings are literals and are to be typed just as 
they appear. 


Italic strings usually represent substitutable argument 
prototypes and program names found elsewhere in the 
manual (they are underlined in the typed version of the 
entries). 


Square brackets [] around an argument prototype 
indicate that the argument is optional. When an 
argument prototype is given as “name” or “file”, it 
always refers to a file name. 


Ellipses ... are used to show that the previous 
argument prototype may be repeated. 


A final convention is used by the commands themselves. 
An argument beginning with a minus ~, plus +, or 
equal sign = is often taken to be some sort of flag 


argument, even if it appears in a position where a file 
name could appear. Therefore, it is unwise to have files 
whose names begin with —, +, or =. 


The DESCRIPTION part discusses the subject at hand. 


The EXAMPLE(S) part gives example(s) of usage, where 
appropriate. 


The FILES part gives the file names that are built into the 
program. 


The SEE ALSO part gives pointers to related information. 


The DIAGNOSTICS part’ discusses the diagnostic 
indications that may be produced. Messages that are 
intended to be self-explanatory are not listed. 


The WARNINGS part points out potential pitfalls. 


The BUGS part gives known bugs and sometimes 
deficiencies. Occasionally, the suggested fix is also 
described. 


A table of contents and a permuted index derived from that 
table precede Section 1. On each tndez line, the title of the 
entry to which that line refers is followed by the appropriate 
section number in parentheses. This is important because there 
is considerable duplication of names among the sections, arising 
principally from commands that exist only to exercise a 
particular system call. 


If the entries are online, they are available via the catman(1) 
command. 


PERMUTED INDEX 


This index includes entries for all pages of both Volumes 1 and 2. 
The entries themselves are based on the one-line descriptions or 
titles found in the NAME portion of each manual page; the 
significant words (keywords) of these descriptions are listed 
alphabetically down the center of the index. 


The index is actually a keyword-in-context (KWIC) index that 
has three columns. To use the index, read the center column to 
look up specific commands by name or by subject topics. Note 
that the entry may begin in the left column or wrap around and 
continue into the left column. A period (.) marks the end of the 
entry, and a slash (/) indicates where the entry has been 
continued or truncated. The right column gives the manual page 
where the command or subject is described. 


/functions of HP 2640 and 2621-series terminals. . . . hp(1) 
/special functions of HP 2640 and 2621-series/ - « hp(1) 
special functions of/ 300, 300s: handle ... . . 300(1) 
/functions of DASI 300 and 300s terminals. . . 300(1) 
functions of DASI/ 300, 300s: handle special .. . . 300(1) 
/of DASI 300 and 300s terminals. .... . . 300(1) 
/ltol3: convert between 3-byte integers and long/ . . 13tol(3C) 
comparison. diff3: 3-way differential file . . . diff3(1) 
TEKTRONIX 4014/ 4014: paginator forthe . . . 4014(1) 
/for the TEKTRONIX 4014 terminal. ..... . 4014(1) 
functions of the DASI/ 450: handle special . . . . 450(1) 
functions of the DASI 450 terminal. /special - » 450(1) 
/parameters for Xylogics 772 half-inch tape/ .. . - xmset(1M) 
between long integer/ 641, 164a: convert . . . . . a641(3C) 
fault. abort: generate an IOT . . abort(3C) 
absolute value. abs: return integer . . . . . abs(3C) 
adb: absolute debugger. .. . . adb(1) 
abs: return integer absolute value. .....-. abs(3C) 
ceiling, remainder, absolute value/ /floor, . . . floor(3M) 
tiop: terminal accelerator interface. . .. . tiop(7) 
socket. accept: accept a connectionona . . accept(2N) 
connection on a socket. accept: accepta . . + «+ « accept(2N) 
allow/prevent LP/ accept, reject: . . . . + « . accept(1M) 


times of/ touch: update 
times. utime: set file 
accessibility of a/ 
numerical/ graphics: 


access and modification .. 
access and modification 
access: determine ..... 
access graphical and ... 


touch(1 


) 
- utime(2) 


access(2) 


- graphics(1G) 


drvalloc, drvbind: access loadable drivers. . . . Iddrv(2) 
in a/ sputl, sgetl: access long integer data - sputl(3X) 
sadp: disk access profiler. ...... sadp(1M) 


common object file 
file systems for optimal 
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access routines. Ildfen: ... 
access time. /copy ...- 


ldfen(4) 


- dcopy(1M) 


locking: exclusive 
/endutent, utmpname: 
access; determine 

or disable process 
acctcon2: connect-time 
acctpre2: process 

shell procedures for 
acetwtmp: overview of 
/and miscellaneous 
diskusg: generate disk 
acct: per-process 
/search and print process 
/merge or add total 
/summary from per-process 
/manipulate connect 
runacct: run daily 
process accounting. 
accounting file format. 
from per-process/ 
print process/ 
connect-time/ 
accounting. acctconl, 
accton, acctwtmp:/ 
acctwtmp:/ acctdisk, 
total accounting files. 
acctdisk, acctdusg, 
process accounting. 
accounting. acctprel, 
/acctdusg, accton, 

sin, cos, tan, asin, 
killall: kill all 

sag: system 

sal, sa2, sadc: system 
sar: system 

SCCS file editing 
process data and system 
protocols. Dialers: 
hopefully interesting, 


acctmerg: merge or 
puteny: change or 

/set DARPA Internet 
/inet_netof: Internet 
setenet: write Ethernet 
administer SCCS files. 
admin: create and 
interface. swap: swap 
Cave. 

alarm: set a process 
alarm clock. 

data segment space 
calloc: main memory 
fast main memory 
accept, reject: 

running process/ renice: 
sort: sort 

and link editor output. 
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access to regions ofa/ ... 
access utmp file entry. ... 
accessibility of afile .... 
accounting. /enable .... 
accounting. acctconl, ... 
accounting. acectprel, ... 
accounting. /turnacct: .. . 
accounting and/ /accton, . 
accounting commands. ... 
accounting data by user/ . . 
accounting file format. ... 
accounting file(s). . 2... 
accounting files. . 2... 
accounting records. .... 
accounting records. .... 
accounting. - . «ese. 
acct: enable or disable ... 
acct: per-process ee cee 
acctems: command summary 
acctcom: search and .... 
acctconl, acctcon2: .... 
acctcon2: connect-time ... 
acctdisk, acctdusg, .... 
acctdusg, accton, ..... 
acctmerg: merge or add. . 
accton, acctwtmp:/ .... 
acctprel, acctpre2: ele Sake 
acctpre2: process .. +e. 
acctwtmp: overview of/ .. 
acos, atan, atan2:/ 2... 
active processes. . 2. 2 2 6 
activity graph. 2... eee 
activity report package. . . 
activity reporter. ..... 
activity. /print current . . 
activity. /report . 2... 
ACU/modem calling .. =. 
adage. /printarandom, . . 
adb: absolute debugger. .. 
add total accounting/ ... 
add valueto/ ... es... 
address from node name. . . 
address manipulation/ .. . 
address on disk. . 2 « ee 
admin: create and ..... 
administer SCCS files. . .. 
administrative . . . 2. . 
advent: explore Colossal .. 
alarm clock. . 2. 2. 6 eee 
alarm: set a process .... 
allocation. /change ... . 
allocator. /realloc, . ... 
allocator. /mallinfo: .... 
allow/prevent LP/ .... 
alter priority of .....-. 
and/or merge files. .... 
a.out: common assembler . . 


locking(2) 
getut(3C) 
access(2) 
acct (2) 
acctcon(1M) 
acct pre(1M) 
acctsh(1M) 
acct(1M) 
acct(1M) 
diskusg(1M) 
acct(4) 
acctcom(1) 
acctmerg(1M) 
acctems(1M) 
fwtmp(1M) 
runacct(1M) 
acct(2) 
acct(4) 
acctems(1M) 
acctcom(1) 
acctcon(1M) 
acctcon(1M) 
acct(1M) 
acct(1M) 
acctmerg(1M) 
acct(1M) 
acetpre(1M) 
acct pre(1M) 
acct(1M) 
trig(3M) 
killall(1M) 
sag(1G) 
sar(1M) 
sar(1) 
sact(1) 
timex(1) 
Dialers(5) 
fortune(6) 
adb(1) 
acctmerg(1M) 
putenv(3C) 
setaddr(1NM) 
inet(3N) 
setenet(1NM) 
admin(1) 
admin(1) 
swap(1M) 
advent(6) 
alarm(2) 
alarm(2) 
brk(2) 
malloc(3C) 
malloc(3X) 
accept(1M) 
renice(1) 
sort(1) 
a.out(4) 


/to commands and 
maintainer for portable/ 
format. 

number: convert 
arithmetic/ be: 
maintainer for/ ar: 
cpio: format of cpio 

ar: common 

header of a member of an 
/convert object and 
Idahread: read the 

tar: tape file 

maintainer for portable 
cpio: copy file 

varargs: handle variable 
/output of a varargs 
xargs: construct 

/get option letter from 
expr: evaluate 

echo: echo 

be: arbitrary-precision 
drill in number facts. 
expr: evaluate arguments 


/and detach serial lines 
/locate a terminal to use 
asa: interpret 

carriage control/ 

ascii: map of 

hd: hexadecimal and 
character set. 

long integer and base-64 
atof: convert 

strings: extract the 
date/ /localtime, gmtime, 
sin, cos, tan, 

help: 

editor/ a.out: common 
as: 

assertion. 

assert: verify program 
setbuf, setvbuf: 

out the list of blocks 
commands at a later/ 
cos, tan, asin, acos, 
/tan, asin, acos, atan, 
string to/ 

strtod, 

integer. strtol, atol, 
string to/ strtol, 
slattach, sldetach: 
process. wait: 

and processing/ 
ungetc: push character 
backgammon. 

back: the game of 

fine: fast incremental 
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application programs. .- 
ar: archive and library . 
ar: common archive file 

Arabic numerals to/ . - 
arbitrary-precision .. - 
archive and library .. 
archive. .« 2 + eee 
archive file format. . . 
archive file. /archive . 
archive files to common/ 
archive header of a/ . « 
archiver. 2 eee eee 
archives. /and library . 
archives in and out. .. 
argument list. . ... 
argument list. . 2... - 
argument list(s) and/_- 
argument vector. .. -« 
arguments asan/ .. .- 
arguments. 2.» 6 es « » 
arithmetic language. . . 
arithmetic: provide . . 
as an expression. .. « 
as: assembler. . 2. 2 « + 
as network interfaces. . 
as the virtual system/ . 
ASA carriage control/ . 
asa: interpret ASA. . 
ASCII character set. . . 
ascii filedump. ... + 
ascii: map of ASCII .. 
ASCII string. /between 

ASCII stringto/ ... 
ASCII text strings in a/ 

asctime, tzset: convert . 
asin, acos, atan, atan2:/ 

ask forhelp. .. 
assembler and link .. 
assembler. ...... 
assert: verify program . 
assertion. . . 2. ee ee 
assign buffering toa/ . 
associated with/ /print 

at, batch: execute 
atan, atan2:/ sin, ... 
atan2: trigonometric/ - 
atof: convert ASCII . . 
atof: convert string to/ . 
atoi: convert string to . 
atol, atoi: convert .. . 
attach and detach serial/ 
await completion of . . 
awk: pattern scanning .- 
back into input stream. 

back: the game of .. . 
backgammon. ....« 
backup. 


ldahread(3X) 
convert(1) 
Idahread(3X) 
tar(1) 

ar(1) 

epio(1) 
varargs(5) 
vprintf(3S) 
xargs(1) 
getopt(3C) 
expr(1) 
echo(1) 

be(1) 
arithmetic(6) 
expr(1) 

as(1) 
slattach(1NM) 
conlocate(1M) 
asa(1) 

asa(1) 
ascii(5) 

hd(1) 

ascii(5) 
a641(3C) 
atof(3C) 
strings(L) 
ctime(3C) 
trig(3M) 
help(1) 
a.out(4) 

as(1) 
assert(3X) 
assert(3X) 
setbuf(3S) 
beheck(1M) 
at(1) 
trig(3M) 
trig(3M) 
atof(3C) 
strtod(3C) 
strtol(3C) 
strtol(3C) 
slattach(1NM) 
wait(1) 
awk(1) 
ungetc(3S) 
back(6) 
back(6) 
fine(1M) 


recover files from a 


terminal capability data 
terminal capability data 
/between long integer and 
/(visual) display editor 
proto file; set links 
deliver portions of/ 

at a later time. at, 
arithmetic language. 
list of blocks/ 

drvload: system/ bre, 
copy. 


eb: C program 
30, j1, jn, yO, yl, yn: 


/install object files in 
fread, fwrite: 

table. bsearch: 
/tdelete, twalk: manage 
bind: 

socket. 

jack. 

bj: the game of 

bcopy: interactive 

sum: print checksum and 
syne: update the super 
/print out the list of 
number of free disk 
manipulate Volume Home 
powerfail, drvload:/ 
segment space/ 

sorted table. 

stdio: standard 

setbuf, setybuf: assign 
mknod: 

vme: VME 

between host and network 
swab: swap 

ec: 

cflow: generate 

cpp: the 

includes: determine 

cb: 

lint: a 

exref: generate 

ctrace: 

and share strings in 
cprofile: setting up a 


de: desk 

eal: print 

service. 

system. cu: 

returned by stat system 
Dialers: ACU/modem 
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backup tape. free: 2. 2. 


banner: make posters. ... 


base. termcap: 
base. terminfo: ..... 
base-64 ASCII string. .. 
based on ex, 2. 2 ew ee 
basename, dirname: ... 
batch: execute commands 
be: arbitrary-precision 
beheck: print out the. 
bcheckre, re, powerfail, . 
beopy: interactive block 
bdiff: big diff... .... 
beautifier. 
Bessel functions. 
bfs: big file scanner. 
binary directories. . . 
binary input/output. 
binary search a sorted 
binary search trees. . 
bind a name toa socket. . 
bind: bind anametoa .. 


frec(1M) 
banner(1) 
termcap(4) 
terminfo(4) 
a641(3C) 


- vi(1) 
based on. /lists from ... 


qlist(1) 
basename(1) 
at(1) 

be(1) 
beheck(1M) 
bre(1M) 


- beopy(1M) 


bdiff(1) 
eb(1) 
bessel(3M) 


- bfs(1) 


. epset(1M) 


- fread(3S) 


bsearch(3C) 


. tsearch(3C) 


bj: the game of black ... 


black jack. 
block copy. . 2... 2.2 
block count of a file. . . . 
block, 2. 2. 2 ee ewe 
blocks associated with/ 
blocks. df: report .. 
Blocks (VHB). libdev: 

bre, beheckre, re, .. 
brk, sbrk: change data 

bsearch: binary search a 


- syne(1) 
- bcheck(1M) 


df(1M) 
libdev(3X) 
bre(1M) 
brk(2) 


- bsearch(3C) 


buffered input/output / - stdio(3S) 
buffering to a stream. - setbuf(3S) 
build special file. ....- mknod(1M) 
bus interface. 2... 2 ee vme(7) 
byte order. /values . byteorder(3N) 
bytes. 2 2 6 «ee 6 « © ~ Swab(3C) 
C compiler. .. 2. ee ees ee(1) 

C flowgraph. 2... eflow(1) 

C language preprocessor. epp(1) 

C language preprocessor/ . . includes(1) 
C program beautifier. . . . cb(1) 

C program checker. « lint(1) 

C program/ «see eee exref(1) 

C program debugger. - ctrace(1) 
C programs. /extract .. . xstr(1) 

C shell environment at/ . . cprofile(4) 
cal: print calendar. . . . « cal(1) 
calculator, . 2... + ++ de(l) 
calendar. 2. ee ee te cal(1) 
calendar: reminder . . . . - calendar(1) 
call another computer - cu(iC) 
call. stat: data .... . . stat(5) 


calling protocols. ... . 


- Dialers(5) 


malloc, free, realloc, 
malloc, free, realloc, 
/introduction to system 
link and unlink system 
requests to an LP/ Ip, 
termeap: terminal 
terminfo: terminal 

asa: interpret ASA 
(variant of ex for 

print files. 

catman: create the 

files for the manual. 
advent: explore Colossal 
beautifier. 


directory. 

commentary of an SCCS/ 
ceiling,/ floor, 

/ceil, fmod, fabs: floor, 
flowgraph. 

delta: make a delta 

of running process by 
create an interprocess 
terminal’s local RS-232 
input/ ungetc: push 
for/ eqnchar: special 
the user. cuserid: get 
/fgetc, getw: get 
/fputc, putw: put 

ascii: map of ASCII 
ASA carriage control 
toascii: translate 
isascii: classify 

tr: translate 

dodisk, lastlogin, / 
directory. 

/file system consistency 
directories/ uucheck: 
constant-width text/ cw, 
mathematical/ eqn, neqn, 
lint: a C program 
password /group file 

file systems with label 
systems processed by/ 
documents/ mm, osdd, 
of a file. sum: print 
group. chown, 

times: get process and 
wait: wait for 


file. 

group of a file. 
owner or group. 
directory. 

directory for a/ 
lastlogin,/ chargefee, 
Jisentrl, isascii: 
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calloc: main memory/ 
calloc, mallopt,/ 


calls and error numbers. .. 
. link(1M) 
- Ip(2) 


calls. /unlink: exercise 
cancel: send/cancel . 
capability data base. . .. 
capability data base. . . . 
carriage control/ .. . 
casual users). /editor . 
cat: concatenate and ... 
cat files for the/ .... 
catman: create the cat . 
Cave. . 
eb: C program ... 2. 
cc: C compiler. .«.... 
ed: change working ... 
ede: change the delta A 
ceil, fmod, fabs: floor, .. 
ceiling, remainder,/ 
cflow: generate C 


malloc(3C) 
malloe(3X) 
intro(2) 


termcap(4) 
terminfo(4) 
asa(1) 
edit(1) 
cat(1) 
catman(1) 
catman(1) 
advent(6) 
eb(1) 
ec(1) 


. cd(1) 
- ede(1) 


(change) toan SCCS/ ... 


changing nice. /priority . 
channel. pipe: .. 2... 
channels. /controlling 
character back into ... 
character definitions .. . 
character login name of. 
character or word from a/ 
character or word ona/ . 
character set. . 2 se oe 
characters. /interpret . . 
characters. /_tolower, 
characters. /fiscntrl, . . 
characters. . 2. ee ee 
chargefee, ckpacct, ... 
chdir: change working . 
check and interactive/ . 
check the UUCP 
checkew: prepare 
checkeq: format 
checker. .. cc eo 
checkers. pwck, grpck: . . 
checking. /labelit: copy 


oe eo © 
ee ee 


checkmm: print/check .. 
checksum and block count 
chgrp: change owner or 
child process times. ... 
child process to stop or/ 
chmod: 
chmod: change mode of 
chown: change owner and 
chown, chgrp: change 
chroot: change root 

chroot: change root ... 
ckpacct, dodisk, 


easy 
floor(3M) 
cflow(1) 
delta(1) 
renice(1) 
pipe(2) 


- tp(7) 
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unget¢(3S) 
eqnchar(5) 
cuserid(3S) 
getc(3S) 
putce(3S) 
ascii(5) 
asa(1) 
conv(3C) 
etype(3C) 
tr(1) 
acctsh(1M) 
chdir(2) 
fsck(1M) 
uucheck(1M) 
ew(1) 
eqn(1 


- lint(1 

- pwek(1M) 
« volcopy(1M) 
checklist: list of file .... 


checklist(4) 
mm(1) 
sum(1) 


» chown(1) 
. times(2) 
- wait(2) 


change mode. .. 


classify characters. ...- 


chroot(2 
chroot(1M) 
acctsh(1M) 
ety pe(3C) 


uucp spool directory 
screen. 

elri: 

clear: 

status/ ferror, feof, 
interpreter) with 
set a process alarm 
cron: 

used. 

Idclose, Idaclose: 
close: 

descriptor. 

fclose, fflush: 


line-feeds. 

advent: explore 

deltas. 

comb: 

lines common to two/ 
nice: run a 

root directory for a 

env: set environment for 
remd: remote shell 

uux: CTIX to CTIX remote 
hangups/ nohup: run a 
with/ csh: a shell 
getopt: parse 

executable file for 

/the standard /restricted 
a stream to a remote 
data and/ timex: time a 
uuxqt: execute remote 
stream to a remote 
per-process/ acctcms: 
system: issue a shell 
condition evaluation 
time: time a 

list(s) and execute 
miscellaneous accounting 
intro: introduction to 
at, batch: execute 
graphical and numerical 
install: install 

mkhosts: make node name 
useful with graphical 
ede: change the delta 
format. ar: 

link editor/ a.out: 

and archive files to 
access routines. Idfen: 
Idopen, Idaopen: open a 
/line number entries of a 
/\daclose: close a 

/the file header of a 

/of a section of a 

/file header of a 
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clean-up. uucleanup: .. 
clear: clear terminal . .. 
clear i-node. . . ew ee 
clear terminal screen. . . 
clearerr, fileno: stream . . 
C-like syntax. /(command 
clock. alarm: 
clock demon. ... 2... 
clock: report CPU time. 
close a common object/ . 
close a file descriptor. .. 
close: close a file ..... 
close or flush a stream. .. 
clri: clear i-node. .... 
cmp: compare two files. . 
col: filter reverse ...-. 
Colossal Cave. ..... 
comb: combine SCCS .. 
combine SCCS deltas. .. 
comm: select or reject . . 
command at low priority. 

command. chroot: change 

command execution. ... 
command execution. . . . 
command execution. . .. 
command immuneto .. 
(command interpreter) . . 
command options. . .. . 
command. path: locate . 
command programming/ . 
command. /for returning 

command; report process . 
command requests. ... 


command. rexec: return 
command summary from 

command. «+. e+e eee 
command. test: 
command. .« . «sees 
command. /argument .. 
commands. /and .... 
commands and application / 
commands at a later/ 
commands. /access 

commands. 
commands, .. .e«+..e.e- 
commands. /network . . 
commentary of an SCCS/ 

common archive file ... 
common assembler and. 
common formats. /object 

common object file ... 
common object file for/ . 
common object file/ . . . 
common object file. ... 
common object file. ... 
common object file. ... 
common object file. ... 


uucleanup(1M) 
clear(1) 
clri(1M) 
clear(1) 
ferror(3S) 
esh(1) 
alarm(2) 
cron(1M) 
clock(3C) 
Idelose(3X) 
close(2) 
close(2) 
fclose(3S) 
clri(1M) 
emp(1) 
col(1) 
advent(6) 
comb(1) 
comb(1) 
comm(1) 
nice(1) 
chroot(1M) 
env(1) 
remd(1N) 


rexec(3N) 
acctems(1M) 
system(3S) 
test(1) 
time(1) 
xargs(1) 
acet({1M) 
intro(1) 

at(1) 
graphics(1G) 
install(1M) 
mkhosts(1NM) 
stat(1G) 
ede(1) 

ar(4) 
a.out(4) 
convert(1) 
Idfen(4) 
Idopen(3X) 
Idlread(3X) 
Idclose(3X) 
Idfhread(3X) 
Idlseek(3X) 
Idohseek(3X) 


/of a section of a 
/section header of a 
/section of a 

symbol table entry of a 
/symbol table entry of a 
/to the symbol table of a 
/line number entries in a 
nm: print name list of 
/information for a 
/section header for a 
/information from a 
/retrieve symbol name for 
symbol table/ syms: 
filehdr: file header for 
Id: link editor for 

/print section sizes of 
/select or reject lines 
/report inter-process 
/standard interprocess 
create an endpoint for 
/file for uucp 

diff: differential file 
emp: 

an SCCS file. seesdiff: 
3-way differential file 
diremp: directory 
regular/ regemp, regex: 
/regular expression 
regular expression 

term: format of 

ee: C 

tic: terminfo 

yacc: yet another 

/erfe: error function and 
wait: await 

pack, peat, unpack: 
symbol table/ Idtbindex: 
cu: call another 

files. cat: 

command. test: 

system. 

uucp/ Devices: 

config: 

interface/ ifconfig: 
spooling/ Ipadmin: 
terminal to use as the/ 
/wtmpfix: manipulate 
connection on a socket. 
getpeername: get name of 
out-going terminal line 
accept: accept a 
connect: initiate a 

part of a full-duplex 
listen: listen for 
acctconl, acctcon2: 
fsck, dfsck: file system 
as the virtual system 
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common object file. . . 
common object file. . . 
common object file. . . 
common object file. /a 

common object file. . . 
common object file. . . 
common object file. . . 
common object file. .. 
common object file. .. 
common object file. .. 
common object file. . . 
common object file/ . . 
common object file .. 
common object files. . . 
common object files. . . 
common object files. . 
common to two sorted/ 
communication facilities / 
communication package. 
communication. socket: 
communications lines. . 
comparator. . «+ «+ -« 
compare two files. . . . 
compare two versions of 
comparison. diff: ... 
comparison. . 2... 
compile and execute .. 
compile and match/ . . 
compile. regemp: .. . 
compiled term file. . . 
compiler. 
compiler. . 2. ee ee 
compiler-compiler. . . « 
complementary error/ . 
completion of process. . 
compress and expand/ . 
compute the index of a . 
computer system. 
concatenate and print . 
condition evaluation . . 
config: configure a CTIX 
configuration file for 


configure a CTIX system. 


configure network ... 
configure the LP ... 
conlocate: locatea .. . 
connect accounting/ . . 
connect: initiatea ... 
connected peer. .... 
connection, fan .. + 
connection on a socket. 

connection on a socket. 

connection. /shut down 
connections on a socket. 
connect-time accounting. 
consistency check and/ . 
console. /to use . ss « 


Idrseek(3X) 
Idshread(3X) 
Idsseek(3X) 
ldtbindex(3X) 
Idtbread(3X) 
ldtbseek(3X) 
linenum(4) 
nm(1) 

reloc(4) 
senhdr(4) 
strip(1) 
Idgetname(3X) 
syms(4) 

fileh dr(4) 
1d(1) 

size(1) 
comm(1) 
ipes(1) 
stdipe(3C) 
socket(2N) 
Devices(5) 
diff(1) 

emp(1) 
secsdiff(1) 
diff'3(1) 
diremp(1) 
regemp(3X) 
regexp(5} 
regcmp(1) 
term(4) 

ec(1) 

tic(1M) 
yace(1) 
erf(3M) 
wait(1) 
pack(1) 
Idtbindex(3X) 
cu(1C) 

ceat(1) 

test(1) 

config( 1M) 
Devices(5) 
config( tM) 
ifconfig(1NM) 
lpadmin(1M) 
conlocate(1M) 
fwtmp(1M) 
connect(2N) 
getpeername(2N) 
dial(3C) 
accept(2N) 
connect(2N) 
shutdown(2N) 
listen(2N) 
acctcon(1M) 
fsck(1M) 
conlocate(1M) 


terminal. 

console: 

math: math functions and 
ew, checkew: prepare 
mkfs: 

list(s) and/ xargs: 
/tbl, and eqn 

with/ Uutry: try to 

Is: list 

toc: graphical table of 
esplit: 

/interpret ASA carriage 
ioctl: 

fentl: file 

init, telinit: process 
msgctl: message 

semcetl: semaphore 
shmctl: shared memory 
fentl: file 

status inquiry and job 
ve: version 

772 half-inch tape 
interface. tty: 

local RS-232/ tp: 
terminals. term: 

units: 

dd: 

to English. number: 
floating-point/ atof: 
integers/ 13tol, ltol3: 
integer and/ a64l, 164a: 
and archive files to/ 
/gmtime, asctime, tzset: 
ecvt, fevt, gevt: 

scanf, fscanf, sscanf: 
archive files/ convert: 
strtod, atof: 

strtol, atol, atoi: 
/htons, ntohl, ntohs: 
dd: convert and 

beopy: interactive block 
and out. cpio: 

optimal access/ dcopy: 
label/ volcopy, labelit: 
files. cp, In, my: 

rep: remote file 

system to CTIX system 
CTIX-to-CTIX system file 
for the UUCP/ uucico: 
image file. 

core: format of 

atan, atan2:/ sin, 
functions. sinh, 

print checksum and block 
we: word 

or move files. 

cpio: format of 
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console: console .... 
console terminal. ... 
constants. ....e+«e 
constant-width text for/ 
construct a file system. . 
construct argument 
constructs. . 2. 2 6 « © 
contact a remote system 
contents of directory. . 
contents routines. ... 
context split. . .... 
control characters. . . 
control device. ...- 
control. ... sees 
control initialization. . . 
control operations. 
control operations. . . 
control operations. .. 
control options. ... . 
control. uustat: uucp . 
control. .. +. .eeee 
controller. /Xylogics . « 
controlling terminal . . 
controlling terminal’s . 
conventional names for . 
conversion program. . - 
convert and copy a file. 

convert Arabic numerals 
convert ASCII string to 

convert between 3-byte 

convert between long. 
convert: convert object . 
convert date and time to/ 
convert floating-point/ . 
convert formatted input. 
convert object and 
convert string to/ 
convert string to/ ... 
convert values between/ 
copy a file. 
copy. 
copy file archives in . . 
copy file systems for . . 
copy file systems with . 
copy, link or move... 
copy. 
copy. uucp:CTIX ... 
copy. /uupick: public. 
copy-in/copy-out program 
core: format of core 
core image file. .... 
cos, tan, asin, acos, « - 
cosh, tanh: hyperbolic . 
count of afile. sum: . . 
count. 2. 2 2 ee oo 
cp, In, mv: copy, link. 
cpio archive. 


oe e © & 


console(7) 
console(7) 
math(5) 
ew(1) 
mkfs(1M) 
xargs(1) 
deroff(1) 
Uutry(1M) 
Is(1) 
toc(1G) 
esplit(1) 
asa(1) 
ioctl(2) 
fentl(2) 
init(1M) 
msgctl(2) 
semctl(2) 
shmetl(2) 
fentl(5) 
uustat(1C) 
ve(1) 
xmset(1M) 
tty(7) 
tp(7) 
term(5) 
units(1) 
dd(1) 
number(6) 
atof(3C) 
13tol(3C) 
aB4I(3C) 
convert(1) 
ctime(3C) 
ecvt(3C) 
scanf(3S) 
convert(1) 
strtod(3C) 
strtol(3C) 
byteorder(3N) 
dd(1) 
beopy(1M) 
cpio(1) 
dcopy(1M) 
volcopy(1M) 
ep(1) 
rep(1N) 
uuep(1C) 
uuto(1C) 
uucico(1M) 
core(4) 
core(4) 
trig(3M) 
sinh(3M) 
sum(1) 
we(1)} 
ep(1) 
cpio(4) 


in and out. 

archive. 

preprocessor. 

shell environment at/ 
files in binary/ 

clock: report 

craps: the game of 
craps. 

images. 

or rewrite an existing/ 
tmpnam, tempnam: 
rewrite an/ creat: 
fork: 

ctags: 

tmpfile: 
communication. socket: 
channel. pipe: 

SCCS files. admin: 
the manual. catman: 
umask: set and get file 


file. 

crontab - user 
generate C program 
optimization/ curses: 
generate hashing/ 
interpreter) with/ 


remote terminal. 

file. 

name for terminal. 
gmtime, asctime, tzset:/ 
software. 

execution. uux: CTIX to 
config: configure a 

uucp: CTIX system to 
system copy. uucp: 
print name of current 
get name of current 
command execution. uux: 
uuto, uupick: public 
debugger. 

computer system. 

ttt, 

uname: print name of 
uname: get name of 
gethostname: get name of 
editing/ sact: print 

in the utmp file of the 
getewd: get path-name of 
handling and/ 
interpolate smooth 

login name of the user. 
fields of each line of/ 

of each line of a/ cut: 
constant-width text for/ 
program/ 
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cpio: copy file archives . . 
cpio: format of cpio ... 
cpp: the C language ... 
cprofile: setting upaC .. 
epset: install object ... 
CPU time used. ..... 
CAPS: oe io ow oe cee 
craps: the gameof .... 
crash: examine system .. 
creat: create a new file .. 
create a name fora/ ... 
create a new fileor ... 
create a new process. .. 
create atags file. .... 
create a temporary file. . 
create an endpoint for .. 
create an interprocess .. 
create and administer .. 
create the cat files for .. 
creation mask. ..... 
cron: clock demon. ... 
crontab - user crontab .. 
crontab file. . 2... «2 
cross-reference. cxref: . . 
CRT screen handling and 

crypt, setkey, encrypt: . . 
esh: a shell (command . . 
esplit: context split. . . . 
ct: spawn getty toa ... 
ctags: create atags ... 
ctermid: generate file .. 
ctime, localtime, ..... 
ctinstall: install ..... 
CTIX remote command . 
CTIX system. ... 2... 
CTIX system copy. ... 
CTIX system to CTIX .. 
CTIX system. uname: .. 
CTIX system. uname: .. 
CTIX to CTIX remote .. 
CTIX-to-CTIX system file/ 
ctrace: C program 
cu: call another 

cubic: tic-tac-toe. .... 
current CTIX system. .. 
current CTIX system. . 
current host. ..... 


current SCCS file 
current user. /the slot 

current working/ ... 
curses: CRT screen ... 
curve. spline: . 2... ee 
cuserid: get character .. 
cut: cut out selected ... 
cut out selected fields .. 
ew, checkew: prepare .. 
exref: generate C 


ee 


epio(1) 
cpio(4) 
epp(1) 
eprofile(4) 
cpset(1M) 
clock(3C) 
craps(6) 
craps(6) 
crash(1M) 
creat(2) 
tmpnam(3S) 
creat(2) 
fork(2) 
ctags(1) 
tmpfile(3S) 
socket(2N) 
pipe(2) 
admin(1) 
catman(1) 
umask(2) 
cron(1M) 
crontab(1) 
crontab(1) 
exref(1) 
curses(3X) 
cry pt(3C) 
esh(1) 
esplit(1) 
et(1C) 
ctags(1) 
etermid(3S) 
ctime(3C) 
ctinstall(1) 
uux(1C) 
config(1M) 
uucp(1C) 
uucp(1C) 
uname( 
uname( 
uux(1C 
uuto(1C) 
etrace(1) 
cu(1C) 

ttt(6) 

uname(1) 
uname(2) 
gethostname(3N) 
sact(1) 
ttyslot(3C) 
getewd(3C)} 
curses(3X) 
spline(1G) 
cuserid(3S) 
cut(1) 

cut(1) 

ew(1) 

exref(1) 


1 
2 
) 


runacct: run 

from node/ setaddr: set 
Transfer Protocol/ ftpd: 
server. telnetd: 

/user interface to the 
Transfer/ tftpd: 
/special functions of 
/special functions of the 
command; report process 
terminal capability 
terminal capability 
generate disk accounting 
access long integer 

lock process, text, or 
prof: display profile 
system call. stat: 

brk, sbrk: change 

types: primitive system 
join: relational 

the mkfs(1) proto file 
tput: query terminfo 
/asctime, tzset: convert 
date: print and set the 
date. 


for optimal access/ 

file. 

adb: absolute 

ctrace: C program 
fsdb: file system 

sdb: symbolic 

a remote system with 
neqn. /special character 
basename, dirname: 

a file. tail: 
commentary of an SCCS 
SCCS/ delta: make a 
SCCS/ cde: change the 
rmdel: remove a 
(change) to an SCCS/ 
comb: combine SCCS 
cron: clock 

errdemon: error-logging 
the error-logging 

mesg: permit or 
nroff/troff, tbl, and/ 
system: system 

close: close a file 
duplicate an open file 
de: 

/sldetach: attach and 
of a file. access: 
preprocessor/ includes: 
file: 

drivers: loadable 

for finite width output 
table. master: master 
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daily accounting. ... . . runacct(1M) 
DARPA Internet address . . setaddr(1NM) 
DARPA Internet File . . . ftpd(1NM) 
DARPA TELNET protocol . telnetd(1NM) 
DARPA TFTP protocol. . tftp(1N) 
DARPA Trivial File . . . . tftpd(1NM) 
DASI 300 and 300s/ .. . . 300(1) 
DASI 450 terminal. .. . . 450(1) 
data and system/ /timea . timex(1) 
data base. termcap: . « « termcap(4) 
data base. terminfo: . . . . terminfo(4) 
data by user ID... . ~~ diskusg(1M) 
data in a/ sputl, sgetl: . . . sputl(3X) 
data in memory. plock: . . plock(2) 
data. 1... 5 eee + © & prof(l) 
data returned by stat .. . stat(5) 
data segment space/ . . . . brk(2) 
data types. . . 2. +. « types(5) 
database operator. . . . . . join(1) 
database. /using .. . . . qinstall(1) 
database. . 2 2 see eee tput(1) 
date and time to string. - ctime(3C) 
date... see eee ene date(1) 
date: print and set the . . . date(1) 

de: desk calculator. . .. . de(1) 
dcopy: copy file systems . . dcopy(1M) 
dd: convert and copya ... dd(1) 
debugger. . + ee eee . adb(1) 
debugger. «2 eee eee etrace(1) 
debugger. ........ fsdb(1M) 
debugger. .-.....  sdb(1) 
debugging on. /contact - Uutry(1M) 


definitions for eqn and . 
deliver portions of path/ 


. eqnchar(5) 
- basename(1) 


deliver the last part of . . . tail(1) 
delta. /change the delta . . cde(1) 
delta (change) to an - - delta(1) 
delta commentary of an . . cde(1) 
delta from an SCCS file. . . rmdel(1) 
delta: make a delta... . delta(1) 
deltas. . 2.2 ee ae + + comb(1) 
demon. . 2 2+ eee eee cron(1M) 
demon... 2. eee eee . errdemon(1M) 
demon. /terminate .. . . errstop(1M) 
deny messages. . . 2. + mesg(1) 
deroff: remove ... ... deroff(1) 
description file. ... . . » system(4) 
descriptor. . . . «+ «+ close(2) 
descriptor. dup: .... . dup(2) 
desk calculator. . . . . ~~ de(1) 


detach serial lines as/ . 
determine accessibility . 
determine C language . 
determine filetype. .. 
device drivers. 


device. /fold long lines . . 


device information 


-10- 


. slattach(1NM) 


access(2) 


- ineludes(1) 
- file(1) 


drivers(7) 
fold(1) 
master(4) 


ioctl: control 

devnm: 

/tekset, td: graphical 
file for uucp/ 


free disk blocks. 
consistency check/ fsck, 
out-going terminal line/ 
calling protocols. 

bdiff: big 

comparator. 

differential file/ 

sdiff: side-by-side 

files. diffmk: mark 
comparator. diff: 

diff3: 3-way 

between files. 
directories. 

comparison. 

uucheck: check the UUCP 
object files in binary 
dir: format of 

rmdir: remove files or 
ed: change working 
chdir: change working 
chroot: change root 
uucleanup: uucp spool 
diremp: 

unlink: remove 

chroot: change root 
make a lost+found 

of current working 

Is: list contents of 
mkdir, mkdirs: make a 
mydir: move a 

pwd: working 

or/ mknod: make a 
portions of/ basename, 
LP printers. enable, 
acct: enable or 

modes, speed, and line 
modes, speed, and line 
sadp: 

user/ diskusg: generate 
report number of free 
remove exchangeable 
disk: general 

driver. 

Ethernet address on 
update: provide 

du: summarize 
accounting data by user/ 


mount, umount: mount and 


exchangeable disk. 
/screen-oriented (visual) 
prof: 

on local/ ruptime: 


5/86 


device. 
device name. 
device routines and/ ... 
Devices: configuration . . 


- ioctl(2) 


devnm: device name. . .. . 


df: report number of ... 
dfsck: file system .... 
dial: establish an . 2... 
Dialers: ACU/modem .. 
diff. 


devnm(1M) 
gdev(1G) 
Devices(5) 
devnm(1M) 
df(1M) 
fsck(1M) 
dial(3C) 


. Dialers(5) 


diff: differential file .... 


diff: way .. 
difference program. 


differences between .... 


differential file ..... 
differential file/ ..... 


dir: format of 
diremp: directory .... 
directories and/ ..... 
directories. /install . 
directories. . 2. 2... we 


directories. rm, ..... 
directory. .. 2... 
directory, .. ese e- 
directory. . +. 2 eeee 


directory clean-up. ... 
directory comparison. . 
directory entry. .... 
directory for a command. 
directory for fsck. 
directory. /path-name 
directory. 
directory. 
directory. . +... 
directory name. ... . 
directory, or a special 

dirname: deliver ... . 
disable: enable/disable 

disable process/ 
discipline. /type, 
discipline. /type, .... 
disk access profiler. ... 
disk accounting data by . 
disk blocks. df: ..... 
disk. dismount: ..... 
disk driver. 


oe ew 


7 es 8 8 8 


bdiff(1) 
diff(1) 


. diff3(1) 
diffmk: mark differences .. 


diffmk(1) 
dir(4) 


. diremp(1) 


uucheck(1M) 


- cpset(1M) 
. dir(4) 


rm(1)} 


. ed(1) 


chdir(2) 
chroot(2) 
uucleanup(1M) 
diremp(1) 
unlink(2) 
chroot(1M) 
mklost+found(1M) 
getcwd(3C) 
Is(1) 

mkdir(1) 
mvdir(1M) 
pwd(1) 


- mknod(2) 


basename(1) 
enable(1) 
acct(2) 
getty(1M) 
uugetty(1M) 


. sadp(1M) 
. diskusg(1M) 


df(1M) 


- dismount(1) 


disk: general disk ..... 
. setenet(1NM) 
. update(1M) 


disk. setenet: write 

disk synchronization. 

disk usage. . 2 2 ee we 
diskusg: generate disk .. 
dismount file system. .. 
dismount: remove .... 
display editor based on/ . 
display profile data. ... 
display status of nodes 
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disk(7) 
disk(7) 


du(1) 


. diskusg(1M) 


mount(1M) 
dismount(1) 
vi(1) 


- prof(1) 
. ruptime(1N) 


hypot: Euclidean 
generate uniformly 
/checkmm: print/check 
package for formatting 
and/ mmt, mvt: typeset 
chargefee, ckpacct, 
whodo: who is 

/atof: convert string to 
ptdl: RS-232 terminal 
lrand48, nrand48,/ 
graph: 

arithmetic: provide 
Xylogics 772/ xmset: set 
disk: general disk 

sxt: pseudo-device 
make a loadable 
drivers: loadable device 
/manage loadable 
drvbind: access loadable 
drivers. 

access loadable/ 
drivers. drvalloc, 
bcheckre, rc, powerfail, 
usage. 

parts of an object / 
status information from 
and ascii file 

od: octal 

an object file. dump: 
file descriptor. 
descriptor. dup: 

echo: 


convert floating-point / 


program. end, etext, 
(variant of ex for/ 
print current SCCS file 
/(visual) display 

ed, red: text 

ex: text 

files. Id: link 

ged: graphical 
assembler and link 
sed: stream 

for casual/ edit: text 
ideeprom: load 

/user, real group, and 
/getegid: get real user, 
FORTRAN, ratfor, or 
file for a/ grep, 
enable/disable LP/ 
process/ acct: 

enable, disable: 
hashing/ crypt, setkey, 
generate hashing 
locations in program. 
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distance function, . .. +. 
distributed/ /lcong48: . . 


hy pot(3M) 


. drand48(3C) 


documents formatted with/ . mm(1) 
documents. /the MM macro mm(5) 
documents, view graphs, - mmt(1) 
dodisk, lastlogin/ ..... acctsh(1M) 
doing what. .... . . . whodo(1M) 
double-precision number. . . strtod(3C) 
download. tdl, gtdl, . .. . tdl(1) 


drand48, erand48, 
draw agraph..... 2 & 


. drand48(3C) 
. graph(1G) 


drill in number facts. . . . arithmetic(6) 
drive parameters for . . . . xmset(1M) 
driver. . 6 6 2 ee © ¢ © « disk(7) 
driver, 2 6 6 0 ee ee © © sxt(7) 
driver for tunable variables. | mktunedrv(1M) 
drivers, 2. ee eee eee drivers(7) 
drivers, 6 0 2 6 « © © «© « Iddrv(1M) 
drivers. drvalloc, . 2... Iddrv(2) 
drivers: loadable device . . drivers(7) 
drvalloc, drvbind: . . .. . Iddrv(2) 
drvbind: access loadable . Iddrv(2) 
drvload: system/ bre, ~~. bre(1M) 
du: summarize disk - du(1) 
dump: dump selected .. . dump(1) 
dump. /error records and . errdead(1M) 
dump. hd: hexadecimal . . hd(1) 
dump. - «2+ -e-+++--. od(l) 
dump selected parts of . . . dump(l) 
dup: duplicate an open . . . dup(2) 
duplicate an open file .. . dup(2) 
echo arguments. . . . . ~ » echo(l 
echo: echo arguments. .. . echo(1 
ecvt, fevt, gevt: . . . .. « ecvt(3C) 
ed, red: text editor. ... . ed(1) 
edata: last locations in . . . end(3C) 
edit: text editor ...... edit(1) 
editing activity. sact: .. . sact(1) 
editor based on ex. «~~ vi(1) 
editor. «eee eee ees ed(1) 
editor, «see eee cee ex(1) 
editor for common object . . Id(1) 
editor, . 2 ss eee eee ged(1G) 
editor output. /eommon . . a.out(4) 
editor, . eee ee eee + sed(1) 
editor (variant of ex .. . . edit(1) 
EEPROM. ....-+-s- ldeeprom(1M) 
effective group IDs. .. . . getuid(2) 


effective user, real/ ... 


- getuid(2) 


efl files. /split ...... fsplit(1) 
egrep, fgrep: search a - grep(1) 
enable, disable: . . . . . . enable(1) 
enable or disable... . . acct(2) 
enable/disable LP/ .. . . enable(1) 
encrypt: generate . . 2... cry pt(3C) 


encryption. /encrypt: 
end, etext, edata: last 
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. crypt(3C) 
. end(3C) 


/getgrnam, setgrent, 
host entry. /sethostent, 
/getnetbyname, setnetent, 
socket: create an 
protocol/ /setprotoent, 
/getpwnam, setpwent, 
entry. /setservent, 
/pututline, setutent, 
Arabic numerals to 
nlist: get 

linenum: line number 
man, manprog: print 
/macros for formatting 
/manipulate line number 
a/ /seek to line number 
a/ /seek to relocation 
wtmp: utmp and wtmp 
get group file 

get network host 
endnetent: get network 
get protocol 

get password file 
endservent: get service 
access utmp file 

object file symbol! table 
/index of a symbol table 
/an indexed symbol table 
write password file 
unlink: remove directory 
command execution. 
environment. 

/setting up a C shell 
profile: setting up an 
environ: user 

execution. env: set 
getenv: return value for 
change or add value to 
inteface, and terminal 
definitions for 
nroff/troff, tbl, and 
format mathematical / 
character definitions / 
rhosts: remote 
nrand48,/ drand48, 

td: graphical/ hpd, 
function and/ 
complementary/ erf, 
interface. 

records and status/ 
demon. 

format. 

sys_nerr:/ perror, 

erf, erfe: 

/and complementary 
/sys_nerr: system 

/to system calls and 
errdead: extract 
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endgrent, fgetgrent: get/ . 
endhostent: get network . 
endnetent: get network/ . 
endpoint for/ «see +s 
endprotoent: gett ... - 
endpwent, fgetpwent: get / 
endservent: get service .. 
endutent, utmpname:/ . . 
English. /convert .... 
entries from name list. . . 
entries in acommon/ . . 
entries in this manual. . . 
entries in this manual. .. 
entries of acommon/ .. 
entries of asectionof .. 
entries of asectionof .. 
entry formats. utmp, .. 
entry. /fgetgrent: .... 
entry. /endhostent: ... 
entry. /setnetent, .... 
entry. /endprotoent: .. 
entry. /fgetpwent: .. . 
entry. /setservent, ... 
entry. /utmpname: ... 
entry. /name for common 

entry of a common object / 
entry of a common object / 
entry. putpwent: 
entry. 2 «e+» ee eee 
env: set environment for . 
environ: user «2. ee oe 
environment at login/ . . 
environment at login/ .. 
environment. 
environment for command 
environment name. ... 
environment. puteny: .. 
environment. /terminal . 
eqn and neqn. /character 

eqn constructs. /remove . 
eqn, neqn, checkeq: ... 
eqnchar: special ..... 
equivalent users. .... 
erand48, lrand48, .... 
erase, hardcopy, tekset, . 
erf, erfc: error . 2. 2. 2 « 
erfe: error function and. 
err: error-logging . + « « 
errdead: extract error .. 
errdemon: error-logging . 
errfile: error-log file ... 
errno, sys_errlist, ....- 
error function and/ ... 
error function. ..... 
error messages. . - + + 
error numbers. .. +. 
error records and status/ . 


ee ee 


ww ESS 


getgrent(3C) 
gethostent(3N) 
getnetent(3N) 
socket(2N) 
getprotoent(3N) 
getpwent(3C) 
getservent(3N) 
getut(3C) 
number(6) 
nlist(3C) 
linenum(4) 
man(1) 

man(5) 
Idlread(3X) 
Idiseek(3X) 
Idrseek(3X) 
utmp(4) 
getgrent(3C) 
gethostent(3N) 
getnetent(3N) 
getprotoent(3N) 
getpwent(3C) 
getservent(3N) 
getut(3C) 
ldgetname(3X) 
Idtbindex(3X) 
ldtbread(3X) 
putpwent(3C) 
unlink(2) 
env(1) 
environ(5) 
eprofile(4) 
profile(4) 
environ(5) 
env(1) 
getenv(3C) 
putenv(3C) 
tset(1) 
eqnchar(5) 
deroff(1) 
eqn(1) 
eqnchar(5) 
rhosts(4N) 
drand48(3C) 
gdev(1G) 
erf(3M) 
erf(3M) 

err(7) 
errdead(1M) 
errdemon(1M) 
errfile(4) 
perror(3C) 
erf(3M) 
erf(3M) 
perror(3C) 
intro(2) 
errdead(1M) 


matherr: 

errfile: 

errdemon: 

errstop: terminate the 
err: 

a report of logged 
hashcheck: find spelling 
of logged errors. 
error-logging demon. 
terminal line/ dial: 
setmnt: 

loadable drivers. 
locations in/ end, 
disk. setenet: write 
function. hypot: 
expression. expr: 

test: condition 

/text editor (variant of 


display editor based on 
crash: 

dismount: remove 
regions of a/ locking: 
execve, execlp, execvp:/ 
execvp:/ execl, execv, 
/execy, execle, execve, 
command. path: locate 
execve, execlp, execvp: 
/argument list(s) and 
later time. at, batch: 
regex: compile and 
requests. uuxqt: 
environment for command 
sleep: suspend 

sleep: suspend 

monitor: prepare 

remote shell command 
rexecd: remote 

profil: 

to CTIX remote command 
execlp, execvp:/ execl, 
execl, execy, execle, 
/execle, execve, execlp, 
system/ link, unlink: 

a new file or rewrite an 
process. 

process. exit, 

sqrt: exponential, / 
unpack: compress and 
and/ expand, unexpand: 
tabs to spaces, and/ 
advent: 

/log, log10, pow, sqrt: 

as an expression. 

match/ regexp: regular 
regemp: regular 

evaluate arguments as an 


5/86 


error-handling function. . 
error-log file format. . . . 
error-logging demon. . . . 
error-logging demon. . .. 
error-logging interface. . . 
errors. errpt: process .. 
errors. /spellin, . ... 
errpt: process areport .. 
errstop: terminate the .. 
establish an out-going .. 
establish mount table. . . 
Iddrv: manage ..... 
etext, edata: last . ... 
Ethernet address on ... 
Euclidean distance . . . . 
evaluate arguments as an . 
evaluation command. .. 
ex for casual users). .. . 
ex: text editor. 
ex. /(visual) 2... 
examine system images. . 
exchangeable disk. . . . - 
exclusive access to . 2... 
execl, execy, execle, .. . 
execle, execve, execlp, . . 
execlp, execvp: execute/ . 
executable file for .... 
execute afile. /execle, . . 
execute command. .... 
execute commands ata . 
execute regular/ regemp, . 
execute remote command . 
execution. env:set ... 
execution foran/ .... 
execution for interval. .. 
execution profile. .... 
execution. remd: .... 
execution server. .... 
execution time profile. .. 
execution. uux:CTIX .. 
execy, execle, execve, . . « 
execve, execlp, execvp:/. 
execyp: execute a file. .. 
exercise link and unlink . 
existing one. /create . . . 
exit, _exit: terminate . .. 
_exit: terminate ..... 
exp, log, logl10, pow, ... 
expand files. /pcat, ... 
expand tabs to spaces, .. 
expand, unexpand: expand 
explore Colossal Cave. .. 
exponential, logarithm,/ . 
expr: evaluate arguments . 
expression compile and . . 
expression compile. .. . 
expression. expr: .... 


-14- 


matherr(3M) 
errfile(4) 
errdemon(1M)} 
errstop(1M) 
err(7) 
errpt(1M) 
spell(1) 
errpt(1M) 
errstop(1M) 
dial(3C) 
setmnt(1M) 
Iddrv(1M) 
end(3C) 
setenet(1NM) 
hy pot(3M) 
expr(1) 


crash(1M) 
dismount(1) 
locking(2) 
exec(2 
exec(2 
exec(2) 
path(1) 
exec(2) 
xargs(1) 
at(1) 
regemp(3X) 
uuxqt(1M) 
env(1) 
sleep(1) 
sleep(3C) 
monitor(3C) 
remd(1N) 
rexecd(1NM) 
profil(2) 
uux(1C) 
exec(2) 
exec(2) 
exec(2) 
link(1M) 
creat(2) 
exit(2) 


regexp(5) 
regemp(1) 
expr(1) 


and execute regular 
strings in C/ xstr: 
and status/ errdead: 
strings in a/ strings: 
floor, ceil, fmod, 
factor: 


values. true, 

in a machine-independent 
fine: 

/mallopt, mallinfo: 

abort: generate an IOT 
flush a stream. 


options. 

floating-point/ ecvt, 
fopen, freopen, 

stream status/ ferror, 
fileno: stream status/ 
and statistics for a/ 
stream. fclose, 

getc, getchar, 
/setgrent, endgrent, 
/setpwent, endpwent, 
a stream. gets, 

a pattern. grep, egrep, 
modification/ utime: set 
Idfcn: common object 
accessibility of a 

tar: tape 

out. cpio: copy 

grpck: password/group 
chmod: change mode of 
owner and group of a 
diff: differential 

3-way differential 
fentl: 

fentl: 

rep: remote 
CTIX-to-CTIX system 
format of core image 
umask: set and get 
crontab - user crontab 
ctags: create a tags 
fields of each line of a 
using the mkfs(1) proto 
dd: convert and copy a 
(change) to an SCCS 
close: close a 

dup: duplicate an open 
type. 

hexadecimal and ascii 
parts of an object 

sact: print current SCCS 
fgetgrent: get group 
fgetpwent: get password 
utmpname: access utmp 
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expression. /compile . . 
extract and share ... 
extract error records . . 
extract the ASCII text . 
fabs: floor, ceiling,/ . . 
factora number. ... 
factor: factor a number. 

false: provide truth .. 
fashion.. /integer data . 
fast incremental backup. 
fast main memory/ . . 
faults: co: o.:6i6 6% vee 
felose, fflush: close or .« 
fentl: file control. ... 
fentl: file control ... 
fevt, gevt: convert .. 
fdopen: open a stream. . 
feof, clearerr, fileno: . . 
ferror, feof, clearerr, . . 
ff: list file names ... 
fflush: close or flusha . 
fgetc, getw: get/ 
fgetgrent: get group/ 
fgetpwent: get password / 
fgets: get a string from . 
fgrep: search a file for . 
file access and ...-. 
file access routines. . . 
file. access: determine . 
file archiver. 


file archives in and. 
file checkers. pwek, . 
file. - 
file. chown: change . 
file comparator. . .. « 
file comparison. diff3: . 
file control. . . 2 2 6 « 
file control options. . . 
file copy. »« « « ee we 
file copy. /public .. . 
file. core: 2 2 «ees 
file creation mask. .. - 
file. 
file. « ee ew eves 
file. /cut out selected . 
file database. /software 
file. cece eaves 
file. /makeadelta .. 
file descriptor. ... 
file descriptor, ... 
file: determine file ... 
filedump. hd: ....- 
file. /dump selected . . 
file editing activity. . . 
file entry. /endgrent, . 
file entry. /endpwent, . 
file entry. /endutent, . 


oe ew oe we ew ew 
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regcmp(3X) 
xstr(1) 
errdead(1M) 
strings(1) 
floor(3M) 
factor(1 
factor(1 
true(1) 
sputl(3X) 
finc(1M) 
malloc(3X) 
abort(3C) 
fclose(3S) 
fentl(2) 
fentl(5) 
ecyt(3C) 
fopen(3S) 
ferror(3S) 
ferror(3S) 
ff(1M) 
fclose(3S) 
getc(3S) 
getgrent(3C) 
getpwent(3C) 
gets(3S) 
grep(1) 
utime(2) 
ldfen(4) 
access(2) 
tar(1) 
cpio(1) 
pwck(1M) 
chmod(2) 
chown(2) 
diff(1) 
diff3(1) 
fentl(2) 
fentl(5) 
rep(1N) 
uuto(1C) 
core(4) 
umask(2) 
crontab(1) 
ctags(1) 
cut(1) 
qinstall(1) 
dd(1) 


sact(1) 
getgrent(3C) 
getpwent(3C} 
getut(3C) 


putpwent: write password 
execvp: execute a 

/egrep, fgrep: search a 
path: locate executable 
/open a common object 
Devices: configuration 
per-process accounting 
ar: common archive 
errfile: error-log 

intro: introduction to 

of a common object 

get a version of an SCCS 
group: group 

object files. filehdr: 
Idfhread: read the 

/seek to the optional 
split: split a 

issue identification 

a member of an archive 
close a common object 
of a common object 

of a common object 

of a common object 

of a common object 

of a common object 

of a common object 
entry of a common object 
entry of a common object 
table of a common object 
in a common object 

link: link toa 

file;/ qlist: print out 
access to regions of a 

an ifile from an object 
mknod: build special 

or a special or ordinary 
ctermid: generate 
mktemp: make a unique 
statistics/ ff: list 

the format of a text 

list of common object 
null: the null 

/the slot in the utmp 

/ processes using a 

creat: create a new 
passwd: password 
subsequent lines of one 
soft-copy/ pg: 

/ftell: reposition a 

Iseek: move read/write 
prs: print an SCCS 

read: read from 

for a common object 

a delta from an SCCS 
bfs: big 

two versions of an SCCS 
secsfile: format of SCCS 
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file entry. 


file. /execve, execlp, ... 
file for a pattern. . 2... 


file for command. 
file for reading. 

filefor uucp/ ..... 
file format. acct: 
file format. 
file format. 
file formats. 
file function. /entries 
file. get: 
file 6-26.36. ite, os 
file header for common . 
file header of a common/ 
file header of a common/ 


eee ee we we 


putpwent(3C) 


. exec(2) 


grep(1) 
path(1) 
Idopen(3X) 
Devices(5) 
acct (4) 
ar(4) 
errfile(4) 
intro(4) 


- Idlread(3X) 
- get(1) 
» group(4) 


filehdr(4) 


- Idfhread(3X) 
. Idohseek(3X) 


file into pieces. .. . ~~ » split(1) 

file. issue: . 2... . © issue(4) 

file. /archive header of . . Idahread(3X) 
file. /Idaclose: .....- Idclose(3X) 
file. /the file header . . . . Idfhread(3X) 
file. /ofasection . 2... Idlseek(3X) 
file. /file header .. . . . Idohseek(3X) 
file. /ofasection »..... ldrseek(3X) 
file. /section header . . . . Idshread(3X) 
file. /section .... .. ~ Idsseek(3X) 
file. /of a symbol table . . Idtbindex(3X) 
file. /symbol table . . . . Idtbread(3X) 
file. /to the symbol . . . . ldtbseek(3X) 
file. /number entries . . . linenum(4) 
files, “ie -oice,ss ertncseca.re ate TOKE) 

file lists from proto... . qlist(1) 

file. /exclusive ... . . . locking( 


file. 
file. 


mkifile: make 


ee ee we ew ew ew 


2) 

(1M 

- mknod(1M) 
(2) 


mkifile 


) 


file. /make a directory, . . mknod 
file name for terminal. . . . ctermid(3S) 
filename. . 2 eee eee mktemp(3C) 
filenamesand ...... ff(1M) 
file. newform: change . . . newform(1) 
file. nm: printname ... . nm(1) 
file. 2. ee ee eee ee null(7) 


file 


- ttyslot(3C) 


file or file structure. . fuser(1M) 
file or rewritean/ ..... creat(2) 
files. — ia0e.les 8 eens ee passwd(4) 
file. /several files or . . . . paste(1) 
file perusal filter for - pg(1) 

file pointer inaf ....-. fseek(3S) 
file pointer. . 2. 2 ee eee Iseek(2) 
files. 9 Série ewes ay WL ee prs(1)} 
Piles: <6: fos ca) oe Cares wane read(2) 
file. /information .. . . . reloc(4) 
file. rmdel: remove .. . . rmdel(1) 
filescanner. . 2... « « bfs(1) 


file. seesdiff: compare 
file. 
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- scesdiff(1) 


scesfile(4) 


for a common object 
/file lists from proto 
fsize: report 

i-node. openi: open a 
stat, fstat: get 

ASCII text strings in a 
from a common object 
/using a file or 

and block count of a 
synchronous write on a 
/name for common object 
syms: common object 
check and/ fsck, dfsck: 
fsdb: 

and statistics for a 

fs: 

mkfs: construct a 
mount and dismount 
mount: mount a 

ustat: get 

mnttab: mounted 
umount: unmount a 
system description 
access/ dcopy: copy 
by/ checklist: list of 
voleopy, labelit: copy 
the last part of a 
format of compiled term 
create a temporary 

a name for a temporary 
modification times of a 
ftp: 

ftpd: DARPA Internet 
tftpd: DARPA Trivial 
ftw: walk a 

file: determine 

TZ: time zone 

previous get of an SCCS 
repeated lines in a 

and Permissions 

val: validate SCCS 
write: write on a 
umask: set 

common object files. 
ferror, feof, clearerr, 
print process accounting 
or add total accounting 
and administer SCCS 
concatenate and print 
emp: compare two 
common to two sorted 
my: copy, link or move 
mark differences between 
header for common object 
find: find 

catman: create the cat 
tape. frec: recover 
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file. /section header . . . . senhdr(4) 
file; set links based/ . .. . qlist(1) 
filesize. . 2 2 2 ee eee fsize(1) 
file specified by ... . . . openi(2) 
file status. 2... ee eee stat(2) 

file. /extractthe ..... strings(1) 
file. /information ... . . strip(1) 
file structure. . . . . . . © fuser(1M) 
file. /print checksum .. . sum(1) 
file. swrite: . 2 we ee ee swrite(2) 
file symbol table entry. . . . Idgetname(3X) 
file symbol table/ .. . . . syms(4) 
file system consistency . . . fsck(1M) 
file system debugger. .. . fsdb(1M) 
file system. /file names . . ff(1M) 

file system format. .. . . fs(4) 
filesystem. .. 2... . mkfs(1M) 
file system. /umount: . . . mount(1M) 
filesystem. . . .. +.» » mount(2) 
file system statistics. . . . . ustat(2) 
file system table. .. . . . mnttab(4) 
filesystem. . 2... 2 - . umount(2) 
file. system: . 2... . system(4) 
file systems for optimal . deopy(1M) 
file systems processed - « checklist(4) 
file systems with label/ . . volcopy(1M) 
file. tail: deliver... .. . tail(1) 
file. term: 2... 2.22. term(4) 
file. tmpfile: . ... . . . tmpfile(3S) 
file. /tempnam: create . . . tmpnam(3S) 
file. /update access and . . touch(l) 
file transfer program. . ftp(1N) 


File Transfer Protocol/ . 
File Transfer Protocol/ 


. ftpd(1NM) 
. tftpd(1NM) 


filetree. 2... 2... ftw(3C) 
filetype. ......... file(1) 
Gil€), * Sores tes eh eee wt SE case t2(4) 

file. unget: undo a . unget(1) 
file. uniq: report ....- uniq(1) 
file. /UUCP directories . uucheck(1M) 
files doers) Si ce fee ue. dal ete val(1) 
file. . 6 2 ee ee ew © © Write(2) 
file-creation mode mask. . . umask(1) 
filehdr: file header for . filehdr(4) 
fileno: stream status/ . ferror(3S) 
file(s). /search and » . ~ acctcom(1) 
files. acctmerg: merge . . - acctmerg(1M) 
files. admin: create . .. . admin(1) 
files. cat: 2. 2 ee. «  cat(l) 
files. . 2 2 2 2 we ee ~~ omp(l) 
files. /or reject lines . . . . comm(1) 
files. cp,In, . 2. eee - cp(1) 
files. diffmk: .... ... diffmk(1) 
files. filehdr: file .. . . © filehdr(4) 
files, 2 2 ee eo we ew ww @ find(1) 


files for the manual. 
files from a backup 
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- catman(1) 


frec(1M) 


specification in text 
ratfor, or efl 

format of graphical 
cpset: install object 
preprocessor include 
introduction to special 
editor for common object 
lockf: record locking on 
rm, rmdir: remove 
/same lines of several 
compress and expand 
pr: print 

sizes of common object 
sort: sort and/or merge 
/object and archive 
what: identify SCCS 
pg: file perusal 

greek: select terminal 
nl: line numbering 
line-feeds. col: 

device routines and 
tplot: graphics 

backup. 

find: 


hyphen: 

ttyname, isatty: 

for an object/ lorder: 
/spellin, hashcheck: 
utmp file of / ttyslot: 
/fold long lines for 
fish: play ‘‘Go 


tee: pipe 

/convert ASCII string to 
/fevt, gevt: convert 
/manipulate parts of 
floor, ceiling, / 

floor, ceil, fmod, fabs: 
cflow: generate C 

felose, fflush: close or 
ceiling,/ floor, ceil, 

for finite width output/ 
finite width/ fold: 
open a stream. 

process. 

accounting file 

ar: common archive file 
errfile: error-log file 

fs: file system 

for/ eqn, neqn, checkeq: 
newform: change the 


inode: 

file... term: 
file. core: 
cpio: 

dir: 
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files. fspec: format .. . . fspec(4) 
files. /split FORTRAN, . . fsplit(1) 
files. /string, ...... . gps(4) 
files in binary/ ... . . . cpset(1M) 
files. /C language... .. includes(1) 
files. intro: 2... ee ee intro(7) 
files. Id: link 2... 2... ld(1 

files, 2 2 2 2 2 we ee © « lockf(3C) 
files or directories. . 2. 2 rm(1) 
files or subsequent/ .. . . paste(1) 
files. /pcat, unpack: . . . . pack(1) 
files, 2 2 2 we ee we ee © pr(l) 
files. /print section . . . . size(1) 
files, 2. 2 2 2 eee ee] Sort(l) 


files to common formats. 


- convert(1) 


files, 2. 2 2 6 2 ew © « © what(1) 
filter for soft-copy/  ... ~ pg(l) 
filter, 2. 2 2 2 eee «© ~ greek(1) 
filter, . 2.5 ee eo © al(l) 
filter reverse 2 2 2 ww ee col(1) 
filters. /td: graphical . . . gdev(1G) 


filters. 


oe © © © © we we 


- tplot(1G) 


fine: fast incremental . . . finc(1M) 
find files. . 2... 2 «6 © © find(l) 
find: find files. ... 2... find(1) 
find hyphenated words. . . hyphen(1) 
find name of a terminal. . . ttyname(3C) 
find ordering relation . . . lorder(1) 
find spelling errors. . . . . spell(1) 
find the slotinthe .. . . ttyslot(3C) 
finite width output/ ... . fold(1) 
Fish”, . . + « ee + « + © fish(6) 
fish: play “Go Fish”. .. . fish(6) 
fitting. . 2. 2 2 6 ee oe tee(l) 
floating-point number. . . . atof(3C) 
floating-point number to/ . ecvt(3C) 
floating-point numbers. . . frexp(3C) 
floor, ceil, fmod, fabs: . . . floor(3M) 
floor, ceiling,/ . 2. 2 eee floor(3M) 
flowgraph. .. 2.2.2 eee cflow(1) 
flush a stream. . - ee ee fclose(3S) 
fmod, fabs: floor, ..... floor(3M) 
fold: fold long lines... . fold(1) 
fold long lines for ..... fold(1) 
fopen, freopen, fdopen: . . . fopen(3S) 
fork: createa new .. 2s fork(2) 
format. /per-process acct(4) 
format. 2... eee eee ar(4) 
format. 2. 6s eee eee errfile(4) 
format. 2. 2 2 eee eee fs(4) 
format mathematical text . eqn(1) 
format of a text file. . . . . newform(1) 
format of an i-node. . . . . inode(4) 
format of compiled term . . term(4) 
format of core image . . . . core(4) 
format of cpio archive. « cpio(4) 
format of directories. - dir(4) 
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/primitive string, 
sccsfile: 

text files. fspec: 

object file symbol table 
or troff. tbl: 

nroff: 

archive files to common 
introduction to file 

utmp and wtmp entry 
fscanf, sscanf: convert 
varargs/ /vsprintf: print 
/fprintf, sprintf: print 
/print/check documents 
/the macro package for 
/the MM macro package for 
this/ man: macros for 
management. netman: 
efi/ f{split: split 
hopefully interesting, / 
formatted/ printf, 

putc, putchar, 

stream. puts, 
input/output. 

a backup tape. 

df: report number of 
main memory/ malloc, 
mallopt,/ malloc, 
stream. fopen, 
manipulate parts of / 
frec: recover files 

/\ine number information 
/receive a message 

get character or word 
fgets: get a string 
mkifile: make an ifile 
rmdel: remove a delta 
/get option letter 

and status information 
read: read 

ncheck: generate names 
nlist: get entries 

DARPA Internet address 
acetcms: command summary 
/print out file lists 
getpw: get name 


formatted input. scanf, 
systems processed by 

make a lost+found directory for 
consistency check and/ 
debugger. 

reposition a file/ 


specification in text/ 
ratfor, or efl files. 

stat, 

pointer/ fseek, rewind, 
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format of graphical/ . . 
format of SCCS file. . . 
format specification in . 
format. syms: common 
format tables for nroff . 
format text. . - 2. 
formats. /object and . 
formats. intro: .... 
formats. utmp, wtmp: . 
formatted input. scanf, 
formatted output ofa . 
formatted output. ... 
formatted with the MM/ 
formatting a permuted/ 
formatting documents. . 
formatting entries in . . 
form-based network .. 
FORTRAN, ratfor, or . 
fortune: print a random, 
fprintf, sprintf: print . . 
fputc, putw: put/ ... 
fputs: put a string on a 
fread, fwrite: binary .. 
frec: recover files from . 
free disk blocks. . ... 
free, realloc, calloc: 
free, realloc, calloc, 
freopen, fdopen: open 
frexp, ldexp, modf: 
from a backup tape. . . 
from a common object / 
from a socket. 
from a stream. /getw: 
from a stream. gets, . 
from an object file. . 
from an SCCS file. .. 
from argument vector. . 
from dump. /records . 
from file. 2 2. 2 ee we 
from i-numbers. 
from name list. .... 
from node name. /set . 
from per-process/ .. « 
from proto file; set/ . . 
from UID. ...2e.. 
fs: file system format. . 
fscanf, sscanf: convert . 
fsck. /list of file 
fsck. 


“pee 


fsck, dfsck: file system . 
fsdb: filesystem .... 
fseek, rewind, ftell: .. 
fsize: report file size. . . 
fspec: format . 
fsplit: split FORTRAN, 

fstat: get file status. . . 
ftell: reposition a file . . 
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gps(4) 
scesfile(4} 
fspec(4) 
syms(4) 
tbi(1) 
nroff(1) 
convert(1) 
intro(4) 
utmp(4) 
scanf(3S) 
vprintf(3S) 
printf(3S) 
mm(1) 
mptx(5) 
mm(5) 
man(5) 
netman(1NM) 
fsplit(1) 
fortune(6) 
printf(3S) 
putc(3S) 
puts(3S) 
fread(3S) 
frec(1M) 
df(1M) 
malloc(3C) 
malloe(3X) 
fopen(3S) 
frexp(3C) 
frec(1M) 
strip(1) 
recv(2N) 
gete(3S) 
gets(3S 

a neIM) 
rmdel(1) 
getopt(3C) 
errdead(1M) 
read(2) 
ncheck(1M) 
nlist(3C) 
setaddr(1NM) 
acctems(1M) 
qlist(1) 
getpw(3C) 
fs(4) 
scanf{(3S) 
checklist(4) 


mklost+found(1M) 


fsck(1M) 
fsdb(1M) 
fseek(3S) 
fsize(1) 
fspec(4) 
fsplit(1) 
stat(2) 
fseek(3S) 


interprocess/ 
program. 
File Transfer Protocol/ 


/shut down part of a 
erf, erfc: error 

and complementary error 
gamma: log gamma 
Euclidean distance 

of a common object file 
matherr: error-handling 
prof: profile within a 
math: math 

jn, yO, yl, yn: Bessel 
power, square root 
absolute value 

ocurse: optimized screen 
/300s: handle special 
hp: handle special 

450/ 450: handle special 
cosh, tanh: hyperbolic 
atan2: trigonometric 
processes using a file/ 
input/output. fread, 
manipulate connect / 
moo: guessing 

back: the 

bj: the 

craps: the 

wump: the 

trk: trekkie 

intro: introduction to 
gamma: log 

function. 

ecvt, fevt, 


maze: 
abort: 

cflow: 

cross-reference. cxref: 
data by user/ diskusg: 
terminal. ctermid: 
crypt, setkey, encrypt: 
i-numbers. ncheck: 
simple lexical/ lex: 
/seed 48, lcong48: 
simple random-number 
stream. gets, fgets: 
file. get: 

getsockopt, setsockopt: 
ulimit: 

of the user. cuserid: 
/getchar, fgetc, getw: 
list. nlist: 

umask: set and 

stat, fstat: 

statistics. ustat: 
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ftok: standard ..... 
ftp: file transfer ..... 
ftpd: DARPA Internet .. 
ftw: walk afile tree. . 1. 
full-duplex connection. . . 
function and/ ......- 
function. /function ... 
function. 
function. hypot: .... 
function. /entries .... 
function. 
function, . 2... ee ee 
functions and constants. . 
functions. j0,jl, .... 
functions. /logarithm, . . 
functions. /remainder, . . 
functions. .... 2s. 
functions of DASI 300/_ 
functions of HP 2640 and/ 
functions of the DASI .. 
functions. sinh, ..... 
functions. /acos, atan, . . 
fuser: identify ...... 
fwrite: binary . 2... 
fwtmp, wtmpfix: .... 
game. «os ee ee ee 
game of backgammon. . . 
game of black jack. ... 
game ofcraps. ....-. 
game of hunt-the-wumpus. 
game. 
games. 2 2 ee ee eee 
gamma function. .... 
gamma: log gamma ... 
gevt: convert/ .. eee 
ged: graphical editor. .. 
generate a maze. .... 
generate an IOT fault. . . 
generate C flowgraph. . . 
generate C program ... 
generate disk accounting . 
generate file name for . . 
generate hashing/ .... 
generate names from... 
generate programs for . . 
generate uniformly/ .. . 
generator. rand, srand: . 
getastring froma ... 
get a version of an SCCS . 
get and set options on/ . 
get and set user limits. . . 
get character login name . 
get character or word/ . . 
get entries from name .. 
get file creation mask. .. 
get file status. 
get file system 
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stdipe(3C)} 
ftp(1N) 
ftpd(1NM) 
ftw(3C) 
shutdown(2N) 
erf(3M 
erf(3M 
gamma(3M) 
hy pot(3M) 
Idlread(3X) 
matherr(3M) 
prof(5) 
math(5) 
bessel(3M) 
exp(3M) 
floor(3M) 
ocurse(3X) 
300(1) 

hp(1) 

450(1) 
sinh(3M) 
trig(3M) 
fuser(1M) 
fread(3S) 
fwtmp(1M) 
moo(6) 
back(6) 
bi(6) 
craps(6) 
wump(6) 
trk(6) 
intro(6) 
gamma(3M) 
gamma(3M) 
ecvt(3C) 
ged(1G) 
maze(6) 
abort(3C) 
cflow(1) 
exref(1) 
diskusg(1M) 
ctermid(3S) 
cry pt(3C) 
ncheck(1M) 
lex(1) 
drand48(3C) 
rand(3C) 
gets(3S) 
get(1) 
getsockopt(2N) 
ulimit(2) 
cuserid(3S) 
getc(3S) 
nlist(3C) 
umask(2) 
stat(2) 
ustat(2) 


SCCS file. 

/endgrent, fgetgrent: 
getlogin: 

logname: 

msgget: 

getpw: 

peer. getpeername: 
system. uname: 

host. gethostname: 
/setnetent, endnetent: 
/sethostent, endhostent: 
unget: undo a previous 
argument/ getopt: 
/endpwent, fgetpwent: 
working/ getewd: 
process times. times: 
/getperp, getppid: 
/endprotoent: 

user,/ /getgid, getegid: 
/setservent, endservent: 
semget: 

segment. shmget: 
getsockname: 
terminal. tty: 

time: 

getw: get character or/ 
get character or/ getc, 
current working/ 
getuid, geteuid, getgid, 
environment name. 
getegid: get/ getuid, 
real/ getuid, geteuid, 
getgrnam, setgrent,/ 
setgrent,/ getgrent, 
getgrent, getgrgid, 
gethostent, 
/gethostbyaddr, 
gethostbyaddr,/ 
current host. 

name. 

getnetent, 

getnetent, getnetbyaddr, 
getnetbyname,/ 

letter from argument/ 
options. 

password. 

connected peer. 
process,/ getpid, 
getppid: get process, / 
getpid, getpgrp, 
/getprotobynumber, 
getprotoent, 
getprotobynumber,/ 
UD. 

getpwnam, setpwent,/ 
getpwent, getpwuid, 
setpwent,/ getpwent, 
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get: get a version ofan .. 
get group file entry. ... 
get login name. 
get login name. 
get message queue. «.. © 
get name from UID. ... 
get name of connected .. 
get name of current CTIX 

get name of current ... 
get network entry. .... 
get network host entry. . 
get of an SCCS file . 1. 
get option letter from .. 
get password file entry. . 
get path-name of current . 
get process and child .. 
get process, process/ . . 
get protocol entry. .... 
get rea) user, effective .. 
get service entry. .... 
get set of semaphores. . . 
get shared memory ... 
get socket name. .... 
get the name ofthe ... 
gettime. . 2. we eee 
getc, getchar, fgetc, ... 
getchar, fgetc, getw: ... 
getcwd: get path-name of 

getegid: get real user,/ . . 
getenv: return value for . 
geteuid, getgid, ..... 
getgid, getegid: gett ... 
getgrent, getgrgid, .... 
getgrgid, getgrnam, ... 
getgrnam, setgrent,/ .. . 
gethostbyaddr,/ ..... 
gethostbyname,/ .... 
gethostent, ....-2.. 
gethostname: get name of 

getlogin: get login... 
getnetbyaddr,/ 
getnetbyname, setnetent,/ 

getnetent, getnetbyaddr, . 
getopt: get option 
getopt: parse command . 
getpass: read a 
getpeername: get name of 

getpgrp, getppid: get .. 
getpid, getpgrp, 
getppid: get process,/ .. 
getprotobyname,/ .... 
getprotobynumber,/ .. . 
getprotoent, . 2. «2 «6» 
getpw: get name from .. 
getpwent, getpwuid, ... 
getpwnam, setpwent,/ .. 
getpwuid, getpwnam, .. 
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get(1) 
getgrent(3C) 
getlogin(3C) 
logname(1) 
msgget(2) 
getpw(3C) 
getpeername(2N) 
uname(2) 
gethostname(3N) 
getnetent(3N) 
gethostent(3N) 
unget(1) 
getopt(3C) 
getpwent(3C) 
getcwd(3C) 
times(2) 
getpid(2) 
getprotoent(3N) 
getuid(2) 
getservent(3N) 
semget(2) 
shmget(2) 
getsockname(2N) 
tty(1) 

time(2) 

getc(3S) 
getc(3S) 
getcwd(3C) 
getuid(2) 
getenv(3C) 
getuid(2) 
getuid(2) 
getgrent(3C) 
getgrent(3C) 
getgrent(3C) 
gethostent(3N) 
gethostent(3N) 
gethostent(3N) 
gethostname(3N) 
getlogin(3C) 
getnetent(3N) 
getnetent(3N) 
getnetent(3N} 
getopt(3C) 
getopt(1) 
getpass(3C) 
getpeername(2N) 
getpid(2) 
getpid(2) 
getpid(2) 
getprotoent(3N) 
getprotoent(3N) 
getprotoent(3N) 
getpw(3C) 
getpwent(3C) 
getpwent(3C) 
getpwent(3C) 


string from a stream. 
/getservbyport, 
getservent, 

getservby port, / 

name. 

get and set options on/ 
settings used by 

type, modes, speed, and/ 
terminal. ct: spawn 
terminal settings used/ 
getegid: get real user,/ 
getutline, pututline,/ 
pututline,/ getutent, 
getutent, getutid, 

getc, getchar, fgetc, 
ctime, localtime, 

fish: play 

longjmp: non-local 
string, format of / 


graph: draw a 

sag: system activity 
graphics: access 
/network useful with 
hardcopy, tekset, td: 
ged: 

/string, format of 

string, format of/ gps: 
contents routines. toc: 
gutil: 

graphical and numerical/ 
tplot: 

plot: 

subroutines. plot: 
/typeset documents, view 
/for typesetting view 
filter. 

search a file for a/ 
/effective user, real 

/get process, process 
chgrp: change owner or 
/endgrent, fgetgrent: get 
group: 


setpgrp: set process 

id: print user and 
group, and effective 
setgid: set user and 
newgrp: log in to a new 
chown: change owner and 
signal to a process or a 
/update, and regenerate 
file checkers. pwek, 
signals. ssignal, 

/or relocate a PT or 
terminal download. tdl, 
hangman: 
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gets, fgets: gta... 
getservbyname,/ ... 
getservbyport,/ .... 
getservent, . . 2 eo « 
getsockname: get socket 
getsockopt, setsockopt: . 
getty. /andterminal . 
getty: set terminal ... 
getty toaremote ... 
gettydefs: speed and .. 
getuid, geteuid, getgid, . 
getutent, getutid, ... 
getutid, getutline, . .. 
getutline, pututline,/ . 
getw: get character or/ . 
gmtime, asctime, tzset:/ 

“Go Fish”, 2... eee 
goto. setjmp, . 2... 
gps: graphical primitive 

graph: draw agraph. . 
graph. 
graph, 2... 2 eee 

graphical and numerical/ 
graphical commands. . 
graphical device/ /erase, 
graphical editor. .... 
graphical files. . .. 
graphical primitive . 
graphical tableof .. 
graphical utilities. . . 
graphics: access ... 
graphics filters. . . 
graphics interface. . 


eee ee wee 


graphics interface 
graphs, and slides. 
graphs and slides. ... 
greek: select terminal . 
grep, egrep, fgrep: . 
group, and effective/ < 
group, and parent/ .. 
group. chown, ... -. 
group fileentry. ... 
group file. .. 2... 
group: group file. ... 
group ID. .....- 
group IDs and names. . 
group IDs. /user, real. 
group IDs. setuid, ... 
group. 
group of a file. 
group of processes. /a « 
groups of programs. .. 
grpck: password/group . 
gsignal: software ... 
GT local printer. ... 
gtdl, ptdl: RS-232 ... 
guess the word. .... 


eee es © we we 
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gets(3S) 
getservent(3N) 
getservent(3N) 
getservent(3N) 
getsockname(2N) 
getsockopt(2N) 
gettydefs(4} 
getty(1M) 
ct(1C) 

getty defs(4) 
getuid(2) 


sag(1G) 
graphics(1G) 
stat(1G) 
gdev(1G) 
ged(1G) 
gps(4) 

gps(4) 
toc(1G) 
gutil(1G) 
graphics(1G) 
tplot(1G) 
plot(4) 


getuid(2) 
setuid(2) 
newgrp(1) 
chown(2) 
kill(2) 
make(1) 
pwck(1M) 
ssignal(3C) 
mktpy(1) 
tdl(1) 
hangman(6) 


moo: 
utilities. 

/for Xylogics 772 
processing. shutdown, 
of DASI 300/ 300, 300s: 
of HP 2640 and/ hp: 

of the DASI 450/ 450: 
list. varargs: 

curses: CRT screen 


/run a command immune to 
graphical/ hpd, erase, 
hinv: 

/hdestroy: manage 
/hashmake, spellin, 
/encrypt: generate 
hashcheck: find/ spell, 
manage hash/ hsearch, 
ascii file dump. 
hsearch, hcreate, 
object/ senhdr: section 
files. filehdr: file 
idfhread: read the file 
to the optional file 
indexed /named section 
/read the archive 


help: ask for 

file dump. hd: 
inventory. 

/manipulate Volume 
fortune: print a random, 
/convert values between 
endhostent: get network 
get name of current 
network. 

/special functions of 
functions of HP 2640/ 
tekset, td: graphical/ 
hdestroy: manage hash/ 
ntohs: convert values/ 
convert values/ htonl, 
wump: the game of 
sinh, cosh, tanh: 

words. 

hy phen: find 

distance function. 
accounting data by user 
set or shared memory 
IDs and names. 

set process group 

issue: issue 

a file or file/ fuser: 
what: 

id: print user and group 
and parent process 

and effective group 
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guessing game. ....s 
gutil: graphical 
half-inch tape/ 2... 
halt: terminate all . . . . 
handle special functions . 
handle special functions 
handle special functions . 
handle variable argument 
handling and/ ..... 
hangman: guess the word. 
hangups and quits. .. 
hardcopy, tekset, td: . . 
hardware inventory. 
hash search tables. . . 
hashcheck: find spelling/ 
hashing encryption. ... 
hashmake, spellin, ... .~ 
hereate, hdestroy: .... 
hd: hexadecimal and 
hdestroy: manage hash/ 
header foracommon .. 
header for common object 
header of acommon/ . . 
header of a common/ /seek 
header of acommon/ /an 
header of a member of an/ 
help: ask for help. 


hexadecimal and ascii 
hiny: hardware 
Home Blocks (VHB). . . .« 
hopefully interesting, / 

host and network byte/ 
host entry. /sethostent, 
host. gethostname: ... 
hosts: list of nodeson . 
HP 2640 and 2621-series/ 
hp: handle special . ... 
hpd, erase, hardcopy, 
hsearch, hcreate, ...-. 
htonl, htons, ntohl, ... 
htons, ntohl, ntohs: 
hunt-the-wumpus. ... . 
hyperbolic functions. . . - 
hyphen: find hyphenated 
hyphenated words. 
hy pot: Euclidean 
ID. generate disk 
id. /queue, semaphore 
id: print user and group 
ID. setpgrp: .. 
identification file. 
identify processes using 
identify SCCS files. . .. 
IDs and names. .... > 
IDs. /process group, .. - 
IDs. /user, real group, 


. 
eee 
eee 

. 
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- moo(6) 


gutil(1G) 
xmset(1M) 
shutdown(iM) 


. 300(1) 


hp(1) 
450(1) 
varargs(5) 
curses(3X) 


- hangman(6) 
- nohup(1) 
- gdev(1G) 


hinv(1M) 
hsearch(3C) 
spell(1) 
erypt(3C) 
spell(1) 
hsearch(3C) 


. ha(1) 
- hsearch(3C) 


senhdr(4) 


- filehdr(4) 
- Idfhread(3. 


x) 
Idohseek(3X) 
3X) 


- Idshread( 
. Idahread(3X) 


help(1) 
help(1) 
hd(1) 
hinv(1M) 


. libdev(3X) 

- fortune(6) 

. byteorder(3N) 
- gethostent(3N) 
- gethostname(3N) 


hosts(4N) 


- hp(1) 


hp(1) 


- gdev(1G) 


hsearch(3C) 
byteorder(3N) 


. byteorder(3N) 


wump(6) 
sinh(3M) 


- hyphen(1) 


hy phen(1) 
hy pot(3M) 


- diskusg(1M) 


iperm(1) 
id(1) 
setpgrp(2) 
issue(4) 


- fuser(1M) 


what(1) 
id(1) 


- getpid(2) 


getuid(2) 


set user and group 
network interface/ 

file. mkifile: make an 
core: format of core 
crash: examine system 
nohup: run a command 
/C language preprocessor 
language preprocessor / 
fine: fast 

/tgoto, tputs: terminal 
formatting a permuted 
Idtbindex: compute the 
ptx: permuted 

entry/ Idtbread: read an 
/\dnshread: read an 

of/ /Idnsseek: seek to an 
inet_ntoa, / 

Internet/ /inet_makeaddr, 
/inet_network, inet_ntoa, 
address/ /inet_Inaof, 
inet_addr, 

inet_addr, inet_network, 
inittab: script for the 
control initialization. 
telinit: process control 
/drvioad: system 
volume. iv: 

a socket. connect: 
process. popen, pclose: 
init process. 

elri: clear 

i-node. 

inode: format of an 

open a file specified by 
blocks associated with 
/start and stop terminal 
convert formatted 

push character back into 
fread, fwrite: binary 
stdio: standard buffered 
fileno: stream status 
uustat: uucp status 
software/ qinstall: 
install: 

commands. 

binary/ cpset: 

or GT/ mktpy, mvtpy: 
ctinstall: 

/set terminal, terminal 
abs: return 

/convert between long 
/sgetl: access long 

atoi: convert string to 
/convert between 3-byte 
3-byte integers and long 
beopy: 

processing/ mailx: 
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IDs. setuid, setgid: .. 
ifconfig: configure .. . 
ifile from an object... 
image file. 
images. .. + 2 eee 
immune to hangups and/ 
include files. .. 2... 
includes: determine C  . 
incremental backup. .. 
independent operations. 
index. /package for 
index of a symbol table/ 
index, 2. 2 ee ee ee 
indexed symbol table . 
indexed /named section/ 
indexed/named section . 
inet_addr, inet_network, 
inet_Inaof, inet_netof: . 
inet_makeaddr,/ ... 
inet_netof: Internet .. 
inet_network, inet_ntoa,/ 
inet_ntoa,/ . 2... 
init process. . «+». 
init, telinit: process .. 
initialization. init, . . . 


eo es © we ee 


initialization shell/ ... 


initialize and maintain . 
initiate a connection on 

initiate pipe to/froma . 
inittab: script forthe . 
i-node. . 2.2 ee ee 
inode: format ofan . . 
i-node. . 2. 2.2 eee e 
i-node. openi: . 2... » 
i-node(s). /the list of . 
input and output. . . 
input. /fscanf, sscanf: . 
input stream. ungetc: . 
input/output. ..... 
input/output package. . 
inquiries. /clearerr, . . 
inquiry and job control. 

install and verify ... 
install commands. .. . 
install: install . 2... . 
install object filesin . . 
install or relocate a PT . 
install software. . 
inteface, and terminal/ . 


integer absolute value. 

integer and base-64/ . 

integer dataina/ ... 
integer. strtol, atol, .. 
integers and long/ .. . 
integers. /between .. 
interactive block copy. . 
interactive message . . 
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setuid(2) 
ifconfig(1NM) 
mkifile(1M) 
core(4) 
crash(1M) 
nohup(1) 
includes(1) 
includes(1) 
finc(1M) 
termcap(3X) 
mptx(5) 
Idtbindex(3X) 
ptx(1) 
ea 
Idshread(3X) 


inet(3N) 
inittab(4) 
init(1M) 
init(1M) 
bre(1M) 
iv(1) 
connect(2N) 
popen(3S) 
inittab(4) 
clri(1M) 
inode(4) 
inode(4) 
openi(2) 
bcheck(1M) 
rsterm(1M) 
scan{(3S) 
ungetc(3S) 
fread(3S) 
stdio(3S) 
ferror(3S) 
uustat(1C) 
qinstall(1) 
install(1M) 
install(1M) 
cpset(1M) 
mktpy(1) 
ctinstall(1) 
tset(1) 
abs(3C) 
a64i(3C) 
sputl(3X) 
strtol(3C) 
13tol(3C) 
13tol(3C) 
beopy(1M) 
mailx(1) 


/consistency check and 
/a random, hopefully 
err: error-logging 

qic: 

Ip: parallel printer 
mem, kmem: system memory 
/configure network 
plot: graphics 

plot: graphics 

swap administrative 
termio: general terminal 
terminal accelerator 
protocol. telnet: user 
TFTP/ tftp: user 
controlling terminal 
vyme: VME bus 

serial lines as network 
node/ setaddr: set DARPA 
/inet_lnaof, inet_netof: 
Protocol/ ftpd: DARPA 
and numbers for the 
protocols: list of 
services: list of 

curve. spline: 

control/ asa: 

esh: a shell (command 
pipe: create an 

ipes: report 

ftok: standard 

suspend execution for an 
suspend execution for 
commands and/ 

file formats. 

games. 

miscellany. 

special files. 
subroutines and/ 
system calls and error/ 
and application/ intro: 
formats. intro: 

intro: 

miscellany. intro: 

files. intro: 

subroutines and/ intro: 
calls and error/ intro: 
generate names from 
hinv: hardware 


abort: generate an 
queue, semaphore set or/ 
inter-process/ 

/isdigit, isxdigit, 

islower, isdigit,/ 
/isgraph, isentrl, 
terminal. ttyname, 
/isprint, isgraph, 
/isupper, islower, 
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interactive repair. . . . 
interesting, adage. .. . 
interface. . 2. ee ee e 
interface for QIC tape. . 
interface. . 2. 2 ee ee 
interface. . 2. 2. ee ee 
interface parameters. . 
interface. . . 2. 2 2 ee 
interface subroutines. . 
interface. swap: .... 
interface. . 2. 2. ee es 
interface. tiop: .... 
interface to TELNET . 
interface to the DARPA 
interface. tty: 2... 
interface. . 2. 2 2 eee 
interfaces. /and detach 

Internet address from. 
Internet address/ .. . 
Internet File Transfer . 
internet. /names .. . 
Internet protocols. . . . 
Internet services. . . . 
interpolate smooth .. 
interpret ASA carriage . 
interpreter) with C-like/ 
interprocess channel. . . 
inter-process/ .« «+ + « 
interprocess/ ....- 
interval. sleep: .... 
interval. sleep: .... 
intro: introduction to. 
intro: introduction to. 
intro: introduction to. 
intro: introduction to. 
intro: introduction to. 
intro: introduction to. 
intro: introduction to. 


introduction to commands 


introduction to file . . 
introduction to games. . 
introduction to... . 
introduction to special . 
introduction to .... 
introduction to system . 
i-numbers. ncheck: .. 
inventory. . +... 
ioctl: control device. . . 
IOT fault. ...... 
iperm: remove a message 
ipes: report . . « e « e 
isalnum, isspace,/ .. . 
isalpha, isupper, . ... 
isascii: classify/ .. .. 
isatty: find nameofa . 
isentrl, isascii:/  . . . 
isdigit, isxdigit,/ .. . 
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fsck(1M) 
fortune(6) 
err(7) 

gic(7) 

Ip(7) 

mem(7) 
ifconfig(1NM) 
plot(4) 
plot(3X) 
swap(1M) 
termio(7) 
tiop(7) 
telnet(1N) 
tftp(1N) 
tty(7) 

vme(7) 
slattach(1NM) 
setaddr(1NM) 
inet(3N) 
{tpd(1NM) 
networks(4N) 
protocols(4N) 
services(4N} 
spline(1G) 
asa(1) 


ncheck(1M) 
hinv(1M) 
ioctl(2) 
abort(3C) 
iperm(1) 
ipes(1) 

ety pe(3C) 
etype(3C) 
ety pe(3C) 
ttyname(3C) 
ety pe(3C) 
ety pe(3C) 


/ispunct, isprint, 
isalpha, isupper, 
/isspace, ispunct, 
/isalnum, isspace, 
/isxdigit, isalnum, 
system: 

file. issue: 
identification file. 
isdigit,/ isalpha, 
Jislower, isdigit, 

news: print news 
maintain volume. 
Bessel functions. 

Bessel functions. j0, 
bj: the game of black 
functions. jO, jl, 
database operator. 
/nrand48, mrand48, 
processes. killall: 
process or a group of/ 
process. 

processes. 

interface. mem, 

quiz: test your 

between 3-byte integers/ 
long integer and/ a64l, 
/copy file systems with 
systems with/ volcopy, 
scanning and processing 
/arithmetic 

cpp: the C 

includes: determine C 
/command programming 
/ckpacct, dodisk, 

shl: shell 

/srand48, seed 48, 
common object files. 
object file. Idclose, 
archive header of a/ 
object file for/ Idopen, 
a common object file. 


parts of/ frexp, 

file access routines. 
header of a common/ 
symbol name for common/ 
manipulate/ Idlread, 
Idlread, Idlinit, 

Idlitem: manipulate/ 

to line number entries/ 
number entries/ Idlseek, 
relocation/ Idrseek, 
Idshread, 
indexed/named/ lIdsseek, 
optional file header of / 
common object file for/ 
to relocation entries / 
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lastlogin, monacct,/ . 


- acctsh(1M) 


isgraph, isentrl,/ . « « . « etype(3C) 
islower, isdigit,/ .... . + ctype(3C) 
isprint, isgraph,/ ... . . ctype(3C) 
ispunct, isprint,/ ... . . ctype(3C) 
isspace, ispunct,/ ... . . etype(3C) 
issue a shell command. . . . system(3S) 
issue identification . . . . - issue(4) 
issue: issue... . + ~~ « issue(4) 
isupper, islower, . . . - 2s etype(3C) 
isxdigit, isalnum,/ ... . . ctype(3C) 
items. ... 2... ... news(l) 
iv: initialize and . .. . .. iv(1) 

jO, jl, jn, yO, yl, yn: - . « bessel(3M) 
jl, jn, yO, yl,yn: ... . ~ bessel(3M) 
TOE. ab aoe ter doles bj(6) 

jn, yO, yl, yn: Bessel . . . . bessel(3M) 
join: relational . 2... join(1) 
jrand48, srand48,/ ..... drand48(3C) 
kill all active . 2... . . killall(1M) 
kill: send a signal to a - kill(2) 
kill: terminatea . 2. 2. kil(2) 
killall: kill all active . + killall(1M) 
kmem: system memory . . . mem(7) 
knowledge. 2.2... ee ee quiz(6) 
I3tol, Itol3: convert . . . » 13tol(3C) 
164a: convert between . . . a641(3C) 
label checking. ... . . « volcopy(1M) 
labelit: copy file . . . . . « volcopy(1M) 
language. awk: pattern . . awk(1) 
language... . «+ « « «+ be(l) 
language preprocessor. . . . cpp(1) 
language preprocessor/ . . . includes(1) 
language... ..- +... Sh(1) 


layer manager. 
lcong48: generate/ .. 
Id: link editor for .... 
\daclose: close a common 

Idahread: read the .... 


ldclose, Idaclose: close . 
Ideeprom: load EEPROM. 
Idexp, modf: manipulate 
Idfen: common object 
Idfhread: read the file . . 
Idgetname: retrieve 
Idlinit, Idlitem: ... 
Idlitem: manipulate line/ 
Idlread, Idlinit, ..... 
Idlseek, Idnlseek: seek 
Idniseek: seek toline . . . 
Idnrseek: seek to 
Idnshread: read an/ 
Idnsseek: seek to an 


Idopen, Idaopen: open a 
Idrseek, Idnrseek: seek 
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shi(1) 


. . drand48(3C) 


- Id(1) 

- Idclose(3X) 
. Idahread(3X) 
Idaopen: open acommon -.. . 


Idopen(3X) 


- ldclose(3X) 
- Ideeprom(1M) 
- frexp(3C) 


- + Idfen(4) 


- Idfhread(3X) 
- Idgetname(3X) 
- Idlread(3X) 


. Idlread(3X) 
- Idlread(3X) 
. - Idlseek(3X) 
) 


Idlseek(3X 
ldrseek(3X) 


. Idshread(3X) 


. » Idsseek(3X) 
Idohseek: seek tothe .... 


Idohseek(3X) 


- Idopen(3X) 
. Idrseek(3X) 


read an indexed/named/ 
to an indexed/named/ 
index of a symbol table/ 
indexed symbol table/ 
symbol table of a/ 
getopt: get option 

for simple lexical / 
programs for simple 
update. Isearch, 

Volume Home Blocks/ 
to subroutines and 
relation for an object 

ar: archive and 

ulimit: get and set user 
/an out-going terminal 
/type, modes, speed, and 
/type, modes, speed, and 
line: read one 

common object/ linenum: 
/\dlitem: manipulate 
/\dniseek: seek to 

strip: strip symbol and 
nl: 

selected fields of each 
/requests to an LP 

Ipset: set parallel 

Ipr: 


update. Isearch, lfind: 
col: filter reverse 

entries in a common/ 
/attach and detach serial 
comm: select or reject 
for uucp communications 
output/ fold: fold long 
head: give first few 

uniq: report repeated 
/files or subsequent 

or/ paste: merge same 
link, unlink: exercise 
object files. Id: 
/common assembler and 


cep, In, mv: copy, 

link: 

link and unlink system/ 
from proto file; set 
checker. 

directory. ls: 

statistics for a/ ff: 

get entries from name 
bcheck: print out the 
file. nm: print name 
processed by/ checklist: 
protocols. protocols: 
services. services: 
network. hosts: 
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Idshread, Idnshread: . . . 
Idsseek, Idnsseek: seek ... 
Idtbindex: compute the 
Idtbread: read an ..... 
Idtbseek: seek tothe .... 
letter from argument/ ... 


. Idshread(3X) 


Idsseek(3X) 


- Idtbindex(3X) 


Idtbread(3X) 
Idtbseek(3X) 
getopt(3C) 


lex: generate programs .. « lex(1) 
lexical tasks. /generate » lex(1) 
Ifind: linear search and . . . lsearch(3C) 
libdev: manipulate . 2... . libdev(3X) 
libraries. /introduction . . intro(3) 
library. /find ordering .. . lorder(1) 
library maintainer for/ . . . ar(1) 
limits. . 2... 2... + ulimit(2) 
line connection. ....- - dial(3C) 
line discipline. ... . . . getty(1M) 
line discipline. ... .. © uugetty(1M) 
Lins, 6 sino Siete Mo eerie line(1) 


line number entriesina . 
line number entries of a/ 

line number entries of a/ . 
line number information/ . 
line numbering filter. ... 
line of a file. /cutout ... 
line printer. . 2. 2. ee eee 
line printer options. .... 
line printer spooler. . ... 
fine: read one line. . . 2 + 
linear search and ... es. 


- linenum(4) 
- Idlread(3X) 
- Idlseek(3X) 


line(1) 
Isearch(3C) 


line-feeds. . . . «+ «+ « col(l) 
linenum: line number . . . linenum(4) 
lines as network/ .. . + « slattach(1NM) 
lines common totwo/ .. - comm(1) 
lines. /file . . +. + + + + Devices(5) 
lines for finite width . . . . fold(1) 

lines, 5 ee ew we ee © « head(l) 
linesinafile. . 2... uniq(1)} 

lines of one file. . 2... + paste(1) 


lines of several files . . 2 « 
link and unlink system/ . . 
link editor for common .. .« 
link editor output. ..... 
link: link to a file. 
link or move files. 
link toafile. . 2... 2 ee 
link, unlink: exercise Pa) 
links based on. /lists .. . 
lint: a C program 
list contentsof ....-.- 
list file names and ....-. 
list. nist: bi Saws ae 
list of blocks/ . 2... 


- nlist(3C) 
- bcheck(1M) 


list of common object .. + nm(1) 

list of file systems .... checklist(4) 
list of Internet... 2 ee protocols(4N) 
list of Internet 1... services(4N) 


list of nodeson 2... wee 
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hosts(4N) 


by terminal/ ttytype: 
uuname: 

handle variable argument 
of a varargs argument 
on a socket. listen: 
connections on a/ 
/construct argument 
qlist: print out file 
move files. ep, 
Ideeprom: 

drivers: 

mktunedrv: make a 
lddrv: manage 
drvbind: access 
asctime, tzset:/ ctime, 
as the/ conlocate: 

for command. path: 
end, etext, edata: last 
data in memory. plock: 
files. 

access to regions of a/ 
lockf: record 

gamma: 

newgrp: 

exponential,/ exp, 
exponential,/ exp, log, 
/pow, sqrt: exponential, 
uulog: output 

process a report of 
network. rwho: who is 
getlogin: get 

logname: get 

cuserid: get character 
logname: return 
passwd: change 

rlogin: remote 

rlogind: remote 


a C shell environment at 
up an environment at 


name of user. 

/164a: convert between 
sputl, sgetl: access 
3-byte integers and 
width output/ fold: fold 
setjmp, 

relation for an object / 
make a 

nice: run a command at 
requests to an LP line/ 
/requests to an 
interface. 

disable: enable/disable 
/\pmove: start/stop the 
reject: allow/ prevent 
lpadmin: configure the 
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list of terminal types . . . . 
list VUCP system names. . . 
list. varargs: . 2... 2a 
list. /formatted output . . 
listen for connections ... 
listen: listen for 2... 2... 
list(s) and execute/ . . 2. 
lists from proto file;/ ... 
In, mv: copy, link or . .. 
load EEPROM. ...... 
loadable device drivers. .. 
loadable driver for/ ...- 
loadable drivers. . .... 
loadable drivers. ....-. 
localtime, gmtime, . .... 
locate a terminal to use .. 
locate executable file . ... 
locations in program. ... 
lock process, text, or .- ... 
lockf: record lockingon .. 
locking: exclusive ..... 
locking on files. . 2. + 2 2 
log gamma function. . ... 
log in toa new group. ... 
log, log10, pow, sqrt: . . .. 
log10, pow, sqrt: 2 w we ee 
logarithm, power, square/. 
logfile information. .... 
logged errors. errpt: . ... 
logged in on local . 2... 
login name. . 2... + eee 
login name. . 2. 2. 26 eee 
login name of the user. . . . 
login name of user. «2. - 
login password. . 2... 
login, 2 eee eee eee 
login server, 2. 2 we eee 
login: signon. » . ee eee 
login time. /setting up .. . 
login time. /setting .... 
logname: get login name. . . 
logname: return login ... 
long integer and base-64/ .. 
long integer dataina/ ... 
long integers. /between . . 
long lines for finite .... 
longjmp: non-local goto. . . 
lorder: find ordering 
lost+found directory for fsck 
low priority. 
Ip, cancel: send/cancel 
LP line printer. . ..- 2 
Ip: parallel printer . .. .- - 
LP printers. enable, 
LP request scheduler and/ . 
LP requests. accept, 
LP spooling system. 


ee ee 
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ttytype(4) 
uuname(1C) 
varargs(5) 
vprintf(3S) 
listen(2N) 
listen(2N) 
xargs(1) 

qlist(1) 

ep(1) 
Ideeprom(1M) 
drivers(7) 
mktunedrv(1M) 
Iddrv(1M) 
lddrv(2) 
ctime(3C) 
conlocate(1M) 
path(1) 
end(3C) 
plock(2) 
lockf(3C) 
locking(2) 
lockf(3C) 
gamma(3M) 
newerp(1) 
exp(3M) 
exp(3M) 
exp(3M) 
uulog(1C) 
errpt(1M) 
rwho(1N) 
getlogin(3C) 
logname(1) 
cuserid(3S ) 
logname(3X) 
passwd(1) 
rlogin(1N) 
rlogind(1NM) 
login(1) 
cprofile(4) 
profile(4) 
logname(1 
logname(3 
a641(3C) 
sputl(3X) 
13tol(3C) 
fold(1) 
setjmp(3C) 
lorder(1) 
mklost+found(1M) 


) 
x) 


enable(1) 
Ipsched(1M) 
accept(1M) 
lpadmin(1M) 


Ipstat: print 

LP spooling system. 
LP/ Ipsched, Ipshut, 
spooler. 

start/stop the LP/ 
printer options. 
start/stop the/ Ipsched, 
information. 

drand48, erand48, 
directory. 

search and update. 
file pointer. 

3-byte integers/ 13tol, 


values. values: 

/long integer data in a 
formatting a/ mptx: the 
formatting/ mm: the MM 
typesetting/ mv: a troff 
m4: 

entries in this/ man: 
formatted with the MM 
mail to users or read 

to users or read mail. 
mail. mail, rmail: send 
message processing/ 
/free, realloc, calloc: 
/mallopt, mallinfo: fast 
regenerate groups/ make: 
iv: initialize and 

ar: archive and library 
an SCCS file. delta: 
mkdir, mkdirs: 

special or/ mknod: 
mktunedrv: 
mklost+found: 
mktemp: 

object file. mkifile: 

and regenerate groups/ 
mkhosts: 

banner: 

terminal/ script: 
memory/ /calloc, mallopt, 
calloc: main memory/ 
calloc, mallopt,/ 

/free, realloc, calloc, 
formatting entries in/ 
entries in this manual. 
/tfind, tdelete, twalk: 
/hereate, hdestroy: 
Iddrv: 

form-based network 
window: window 

wm: window 

shl: shell layer 

fwtmp, wtmpfix: 
/\diinit, Idlitem: 
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LP status information. . . 
Ipadmin: configure the 
Ipmove: start/stop the 
Ipr: line printer ..... 
Ipsched, Ipshut, Ipmove:  . 
Ipset: set parallel line 
Ipshut, I|pmove: ..... 
Ipstat: print LP status 
lrand48, nrand48,/ ... 
Is: list contents of .... 
Isearch, Ifind: linear . .. 
Iseek: move read/write .. 
Itol3: convert between .. 
m4: macro processor. a: Se 
machine-dependent ... 
machine-independent/ 
macro package for .... 
macro package for .... 
macro package for .... 
macro processor. «.. « « 
macros for formatting .. 
macros. /documents ... 
mail. mail, rmail: send . . 
mail, rmail: send mail .. 
mail to users or read . 
mailx: interactive . . 
main memory allocator. . 
main memory allocator. . 
maintain, update, and .. 
maintain volume. ...- 
maintainer for portable/ . 
make a delta (change) to . 
make a directory. ... « 
make a directory, ora .. 
make a loadable driver/ . 


make a lost+found directory 


make a unique file name. . 
make an ifilefroman .. 
make: maintain, update, . 


make node name commands. 


make posters. . . . « « « 
make typescriptof ... 
mallinfo: fast main ... 
malloc, free, realloc, .. . 
malloc, free, realloc, ... 
mallopt, mallinfo: fast/ . 
man: macros for .. «+ « 
man, manprog: print . . . 
manage binary search/ . . 
manage hash search/  . . 
manage loadable drivers. . 
management. netman: . . 
management primitives. . 
management. 
manager. » ee ee eee 
manipulate connect/ . . . 
manipulate line number/ . 
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Ipstat(1) 
Ipadmin(1M) 
Ipsched(1M) 
Ipr(1) 
Ipsched(1M) 
Ipset(1M) 
Ipsched(1M) 
Ipstat(1) 
drand48(3C) 
Is(1) 
Isearch(3C) 
Iseek(2) 
13tol(3C) 
m4(1) 
values(5) 
sputl(3X) 
mptx(5) 
mm(5) 
mv(5) 

m4(1) 
man(5) 
mm(1) 
mail(1) 
mail(1) 
mail(1) 
mailx(1) 
malloc(3C) 
malloc(3X) 
make(1) 


mknod(2) 
mktunedrv(1M) 
mklost+found(1M) 
mktemp(3C) 
mkifile(1M) 
make(1) 

mk hosts(1NM) 
banner(1) 
script(1) 
malloc(3X) 
malloc(3C) 
malloc(3X) 
malloc(3X) 
man(5) 

man(1) 
tsearch(3C) 
hsearch(3C) 
Iddrv(1M) 
netman(1NM) 
window(7) 
wm(1) 

shl(1) 
fwtmp(1M) 
Idiread(3X) 


frexp, ldexp, modf: 
tables. route: manually 
Blocks (VHB). libdev: 
/Internet address 

in this manual. man, 
the cat files for the 
print entries in this 
entries in this 

routing tables. route: 
terminal input/ rsterm: 
set. ascii: 

files. diffmk: 

set file-creation mode 
and get file creation 
information/ master: 
information table. 
expression compile and 
constants. math: 
constants. 

/neqn, checkeq: format 
function. 


maze: generate a 

vax: provide truth/ 
interface. 

memepy, memset: memory / 
memset: memory/ memecpy, 
memory/ memccpy, memchr, 
memecpy, memchr, mememp, 
realloc, calloc: main 
/mallinfo: fast main 

shmctl: shared 

semaphore set or shared 
mem, kmem: system 
/mememp, memcpy, memset: 
shmop: shared 

text, or data in 

shmget: get shared 

memchr, mememp, memcpy, 
sort: sort and/or 
accounting/ acctmerg: 
several files or/ paste: 
messages. 

operations. msgctl: 
/recvfrom: receive a 

msgop: 

mailx: interactive 

msgget: get 

set or/ iperm: remove a 
send, sendto: send a 

mesg: permit or deny 
sys_nerr: system error 
directory. 

directory. mkdir, 

system. 

/software using the 
commands. 
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manipulate parts of/ .... 
manipulate the routing .. . 
manipulate Volume Home. 
manipulation routines. .. . 
manprog: print entries ... 
manual. catman: create . . 
manual. man, manprog: . . 
manual. /for formatting . . 
manually manipulate the . . 
manually start and stop .. 
map of ASCII character . . 
mark differences between . . 
mask. umask: ... 2... 
mask. umask: set . . 2. 
master device . 2... eee 
master: master device... 
match routines. /regular . . 
math functions and .... 
math: math functions and . 
mathematical text for/ .. . 
matherr: error-handling . . 
maze: generate a maze. . . . 
maze. 2 eee eee eee 
mc68k, pdp1l, u3b, u3b5, . 
mem, kmem: system memory 
memcecpy, memchr, mememp, 
memchr, mememp, memepy, 

memecmp, memcpy, memset: 

memepy, memset: memory/ 

memory allocator. /free, . - 
memory allocator. .. +... 
memory control/ ....+- 
memory id. /queue, .... 
memory interface. . ... 
Memory operations. .... 
memory operations. .... 
memory. /lock process, . . 
memory segment. 
memset: memory/ memcecpy, 
merge files. . 2. 2. we ew eee 
merge or add total .... 
merge same linesof .... 
mesg: permit ordeny ... 
message control 
message from a socket. . . . 
message operations. . .-- 
message processing/ ...- - 
message queue. .. + eo 
message queue, semaphore . 
message to a socket. . ..- - 
messages. 
messages. /sys_errlist, . . . 
mkdir, mkdirs: makea ... 
mkdirs: makea ... eee 
mkfs: construct afile ... 
mkfs(1) proto file/ .....- 
mkhosts: make node name . 


frexp(3C) 
route(I1NM) 
libdev(3X) 
inet(3N) 
man(1) 
catman(1) 
man(1) 
man(5) 
route(1NM) 
rsterm(1M) 
ascii(5) 
diffmk(1 
umask(1 
umask(2) 
master(4) 
master(4} 
regexp(5) 
math(5) 
math(5) 
eqn(1) 
matherr(3M) 
maze(6) 
maze(6) 
machid(1) 
mem(7) 
memory 
memory 
memory 
memory 
malloc(3C 
malloc(3X 
shmetl(2) 
iperm(1) 
mem(7) 
memory(3C) 
shmop(2) 
plock(2) 
shmget(2) 
memory(3C) 
sort(1) 
acctmerg(1M) 
paste(1) 
mesg(1) 
msgctl(2) 
recy(2N) 
msgop(2) 
mailx(1) 
msgget(2) 
iperm(1) 
send(2N) 
mesg(1) 
perror(3C) 
mkdir(1) 

mk dir(1) 
mkf's(1M) 
qinstall(1) 
mkhosts(1NM) 


pp 


3C) 
3C) 
3C) 
3C) 
) 
) 


from an object file. 
lost+found directory / 
file. 

or a special or/ 

file name. 

relocate a PT or GT/ 
driver for tunable/ 
formatting/ mm: the 
formatted with the 
print/check documents/ 
for formatting/ 
documents, view graphs, / 
system table. 

chmod: change 

umask: set file-creation 
chmod: change 

/set terminal type, 

/set terminal type, 

of/ frexp, ldexp, 

touch: update access and 
/set file access and 
/dodisk, lastlogin, 
execution profile. 
uusub: 


perusal. 

mount: 

system. mount, umount: 
system. 

setmnt: establish 
dismount file system. 
table. mnttab: 

mvdir: 

In, mv: copy, link or 
pointer. lseek: 

LP request scheduler and 
for formatting a/ 
/lrand48, nrand48, 
operations. 

queue. 

operations. 

package for typesetting/ 
files. cp, In, 


view graphs, and/ mmt, 
relocate a PT or/ mktpy, 
from i-numbers. 
mathematical text/ eqn, 
definitions for eqn and 
network management. 
status. 

/values between host and 
/endnetent: get 
/endhostent: get 

hosts: list of nodes on 
ifconfig: configure 

detach seria] lines as 
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mkifile: make an ifile ... 
mklost+found: makea .. . 
mknod: build special . . .. 
mknod: make a directory, . 
mktemp: make aunique .. 
mktpy, mvtpy: install or 
mktunedrv: make a loadable 
MM macro package for .. 
MM macros. /documents . 
mm, osdd, checkmm: .. . 
mm: the MM macro package 
mmt, mvt: typeset . . .. 
mnttab: mounted file .. . 
mode. 2. +. s.e« eee eee 
mode mask. 
mode of file. . 2... ee. 
modes, speed, and line/. . 
modes, speed, and line/ . . 
modf: manipulate parts .. 
modification times of a/  . . 
modification times. .... 
monacct, nulladm,/ .... 
monitor: prepare ..... 
monitor uucp network. ... 
moo: guessing game. ... « 
More, page: text . « « « « « 
mount a file system. . .. © 
mount and dismount file . . 
mount: mount a file 
mount table. . 2... 2 oe 
mount, umount: mount and 

mounted file system 
move a directory. 

move files. cp, . 2... 
move read/write file ... 
move requests. /the .... 
mptx: the macro package . . 
mrand48, jrand48,/ 
msgcetl: message control . . 
msgget: get message . 2. « e 
msgop: message 
mv: atroff macro ..... 
mv: copy, link or move ... 
mvdir: move a directory. .. 
mvt: typeset documents, .. 
mvtpy: install or 
ncheck: generate names. . 
negn, checkeq: format .. . 
neqn. /special character . . 
netman: form-based .... 
netstat: show network .. . 
network byte order. .... 
network entry. .... se 
network host entry. 
network. 2 «eee ec eee 
network interface/ 
network interfaces. /and . . 


oe eo we 
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mkifile(1M) 
mklost+found(1M} 
mknod(1M) 
mknod(2) 
mktemp(3C) 
mktpy(1) 
mktunedry(1M) 
mm(5) 
mm(1) 
mm(1) 
mm(5) 
mmt(1) 
mnttab(4) 
chmod(1) 
umask(1) 
chmod(2) 
getty(1M) 
uugetty(1M) 
frexp(3C) 
touch(1) 
utime(2) 
acctsh(1M) 
monitor(3C) 
uusub(1M) 
moo(6) 


mount(1M) 
mnttab(4) 
mvdir(1M) 
ep(1) 

Iseek(2) 
Ipsched(1M) 
mptx(5) 
drand48(3C) 
msgetl(2)} 
msgget(2) 
msgop(2) 
my(5) 

cp(1) 

my dir(1M) 
mmt(1) 
mktpy(1) 
ncheck(1M) 
eqn(1) 
eqnchar(5) 
netman(1NM) 
netstat(1N) 
byteorder(3N) 
getnetent(3N) 
gethostent(3N) 
hosts(4N) 
ifeconfig(1NM) 
slattach(1NM) 


netman: form-based 
status of nodes on local 
is logged in on local 
netstat: show 

stat: statistical 
uuepd: 

uusub: monitor uucp 
numbers for the/ 
format of a text file. 
group. 

news: print 


a process. 
process by changing 

low priority. 

filter. 

name list. 

common object file. 
mkhosts: make 

Internet address from 
rwhod: 

/display status of 

hosts: list of 

immune to hangups and/ 
setjmp, longjmp: 
/erand48, lrand48, 


mathematical text for 
tbl: format tables for 
eqn/ deroff: remove 
values/ htonl, htons, 
htonl, htons, ntohl, 
null: the 


/lastlogin, monacct, 

ni: line 

number: convert Arabic 
/access graphical and 

to/ convert: convert 
routines. Idfen: common 
selected parts of an 
/\daopen: open a common 
/entries of a common 
Idaclose: close a common 
file header of a common 
of a section of a common 
file header of a common 
of a section of a common 
header of a common 
/section of a common 
table entry of a common 
table entry of a common 
symbol table of a common 
entries in a common 
make an ifile from an 
name list of common 
information for a common 
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network management. . . 
network. /display .... 


. hetman(1NM) 
. ruptime(1N) 


network. rwho: who . . . . rwho({1N) 
network status. .... . . netstat(1N) 
network useful with/ . . . stat(1G) 


network uucp server. 
network. 
networks: namesand .. 
newform: change the . . 


eee we ewe ee 


- « uucpd(1NM) 
- . uusub(1M) 


networks(4N) 


. « newform(1) 


newgrp: logintoanew . . newgrp(1) 
news items. . . . » + « «+ « news(1) 
news: print news items. . news(1) 

nice: change priority of . . . nice(2) 

nice. fof running .. . . « renice(1) 

nice: run a command at . . nice(1) 

ni: line numbering . . . . . ni(1) 

nlist: get entries from - « nilist(3C) 

nm: print name list of . . . nm(1) 

node name commands. . . . mkhosts(1NM) 


node name. /set DARPA 
node status server. ... 
nodes on local network. 
nodes on network. .... 
nohup: run a command 
non-local goto. ..... 
nrand48, mrand48,/ . 


. setaddr(1NM) 
. twhod(1NM) 
. . Tuptime(1N) 
. hosts(4N) 
» » nohup(1) 
. setjmp(3C) 
. drand48(3C) 


nroff: format text. . . . + . nroff(1) 

nroff or troff. /format . . . eqn(1) 

nroff or troff. . . ... . . tbi(l) 
nroff/troff, tbl, and .. . . deroff(1) 
ntohl, ntohs: convert . . . . byteorder(3N) 
ntohs: convert values/ . . . byteorder(3N) 
null file. . 2. 2... +. nuli(7) 

null: the null file. ..... null(7) 
nulladm, pretmp,/ . . . » . acctsh(1M) 
numbering filter. ..... ni(1) 


numerals to English. . . . . 
numerical commands. 
object and archive files . .. 
object file access . 2... 
object file. dump: dump . 
object file for reading. ... 
object filefunction. ... . 
object file. Idclose, ... 
object file. /read the 
object file. /entries .... 
object file. /optional 
object file. /entries 
object file. /section .... 
object file. 
object file. 
object file. 
object file. 
object file. 
object file. 
object file. 
object file. 


/a symbol 
/symbol ... 
/tothe ... 
/number .... 
mkifile: . .. 
nm: print 
[relocation 
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number(6) 


- graphics(1G) 


convert(1) 
Idfen(4) 


. dump(1) 


Idopen(3X) 
Idlread(3X) 


- Idclose(3X) 
. Idfhread(3X) 


Idlseek(3X) 


. Idohseek(3X) 
. Idrseek(3X) 


Idshread(3X) 
Idsseek(3X) 


. Idtbindex(3X) 
. Idtbread(3X) 
. Idtbseek(3X) 


linenum(4) 


. mkifile(1M) 
» nm(1) 
» Teloc(4) 


header for a common 
/from a common 

/symbol name for common 
format. syms: common 
file header for common 
cepset: install 

link editor for common 
section sizes of common 
ordering relation for an 
od: 


functions. 


file/ Idopen, Idaopen: 
i-node. openi: 

fopen, freopen, fdopen: 
dup: duplicate an 
writing. open: 

or writing. 

specified by i-node. 
profiler. prf: 

/prfde, prfsnap, prfpr: 
memepy, memset: memory 
msgctl: message control 
msgop: message 
semaphore control 
semop: semaphore 
shared memory control 
shmop: shared memory 
strespn, strtok: string 
terminal independent 
relational database 
/copy file systems for 
/CRT screen handling and 
functions. ocurse: 
argument/ getopt: get 
a/ ldohseek: seek to the 
fentl: file control 

stty: set the 

getopt: parse command 
parallel line printer 
/setsockopt: get and set 
object/ lorder: find 
/or a special or 
print/check/ mm, 

dial: establish an 

and link editor 

lines for finite width 
information. uulog: 
/print formatted 
sprintf: print formatted 
stop terminal input and 
and/ /accton, acctwtmp: 
file. chown: change 
chown, chgrp: change 
compress and expand/ 
and optimization 

mptx: the macro 
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object file. /section .. - 
object file. 2 . 2 we we 
object file symbol table/  . 
object file symbol table. 
object files. filehdr: ... 
object files in binary/ .. 
object files. Id: ..... 
object files. /print ... 
object library. /find ... 
octaldump. ...-+ +. 
ocurse: optimized screen . 
od: octal dump. ....-. 
open a common object .. 
open a file specified by .. 
open astream. .. +6 « 
open file descriptor. .. . 
open for readingor ... 
open: open for reading . . 
openi:openafile .... 
operating system .... 
operating system/ ... . 
operations. /mememp, . .« 
operations. 
operations. 
operations. 
operations. 


semetl: ... 
operations. shmetl: ... 
Operations. . 2... eee 
operations. /strspn, ..- 
operations. /tputs: ... 
operator. join: ... 6. 
optimal access time. .. - 
optimization package. .. 
optimized screen... 
option letter from .... 
optional file header of .. 
options. 
options for a terminal. .. 
options. .-. 2. «es e-e 
options. |pset:set .. . - 
options on sockets. ... 
ordering relation for an. 
ordinary file. 2... 2. 
osdd, checkmm: ..... 
out-going terminal line/ . 
output. /assembler .. . 
output device. /long .. 
output logfile .....-. 
output of a varargs/ .. . 
output. /fprintf, .... 
output. /startand ... 
overview of accounting .. 
owner and groupofa .. 
owner or group. . . + «+ 
pack, peat, unpack: ... 
package. /handling 
package for formatting a/ 
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scnhdr(4) 
strip(1) 
Idgetname(3X) 
syms(4) 
filehdr(4) 
epset(1M) 


od(1) 
ocurse(3X) 
od(1) 
Idopen(3X) 
openi(2) 
fopen(3S) 
dup(2) 
open(2) 
open(2) 
openi(2) 
prf(7) 
profiler(1M) 
memory(3C) 
msgctl(2) 
msgop(2) 
semctl(2) 
semop(2) 
shmcetl(2) 
shmop(2) 
string(3C) 
termcap(3X) 
join(t) 
deopy(1M) 
curses(3X) 
ocurse(3X) 
getopt(3C) 
Idohseek(3X) 
fentl(5) 
stty(1) 
getopt(1) 
Ipset(iM) 
getsockopt(2N) 
lorder(1) 
mknod(2) 
mm(1) 
dial(3C) 
a.out(4) 
fold(1) 
uulog(1C) 
vprintf(3S) 
printf(3S) 
rsterm(1M) 
acct(1M) 
chown(2) 
chown(1) 
pack(1) 
curses(3X) 
mptx(5) 


mm: the MM macro 
view/ mv: a troff macro 
system activity report 
buffered input/output 
communication 

more, 

TEKTRONIX 4014/ 4014: 
options. Ipset: set 
interface. Ip: 

772/ xmset: set drive 
network interface 
/process group, and 
getopt: 

password. 


/endpwent, fgetpwent: get 
putpwent: write 
passwd: 

getpass: read a 

passwd: change login 
checkers. pwek, grpck: 
of several files or/ 

file for command. 
deliver portions of 
working/ getcwd: get 
search a file for a 
processing/ awk: 

until signal. 

and expand files. pack, 
to/from a/ popen, 
provide truth/ mc68k, 
get name of connected 
the UUCP directories and 
mesg: 

package for formatting a 
ptx: 

file format. acct: 
/command summary from 
sys_errlist, sys_nerr:/ 
soft-copy/ pg: file 
more, page: text 

for soft-copy/ 

split: split a file into 
interprocess channel. 
tee: 

popen, pclose: initiate 
fish: 

text, or data in/ 
interface. 

subroutines. 

/ftell: reposition a file 
move read/write file 
pipe to/from a process. 
library maintainer for 
/dirname: deliver 
banner: make 

exp, log, log10, 
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package for formatting/ 
package for typesetting 
package. /sa2, sade: . 
package. /standard .. 
package. /interprocess 
page: text perusal. . . . 
paginator forthe .. 
parallel line printer . . 
parallel printer .... 
parameters for Xylogics 
parameters. /configure 
parent process IDs. .. 
parse command options. 
passwd: change login 
passwd: password file. . 
password file entry. .. 
password file entry. . . 
password file. 
password, 
password. . 2... 
password/group file . . 
paste: merge same lines 
path: locate executable 
path names. /dirname: 
path-name of current . 
pattern. /egrep, fgrep: . 
pattern scanning and. 
pause: suspend process . 
peat, unpack: compress 
pelose: initiate pipe .. 
pdpll, u3b, u3b5, vax: . 
peer. getpeername: .. 
Permissions file. /check 
permit or deny messages. 
permuted index. /macro 
permuted index. .... 
per-process accounting . 
per-process accounting/ 
perror, errno, « «+ + « 
perusal filter for... . 
perusal, . 2. ee eee 
pg: file perusal filter . . 
pieces. oe eee. 
pipe: create an .... 
pipe fitting. ...... 
pipe to/from a process. 
play ‘‘Go Fish”. 
plock: lock process, . . 
plot: graphics . 2... 
plot: graphics interface . 
pointer in astream. . . 
pointer. Iseek: 
popen, pclose: initiate . 
portable archives. /and 
portions of path names. 
posters. .. esses 
pow, sqrt: exponential, / 
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mm(5) 
my(5) 
sar(1M) 
stdio(3S) 
stdipe(3C) 


xmset(1M) 
ifconfig(INM) 
getpid(2) 
getopt(1) 
passwd(1) 
passwd(4) 
getpwent(3C) 
putpwent(3C) 
passwd(4) 
getpass(3C) 
passwd(1) 
pwek(1M) 
paste(1) 
path(1) 
basename(1) 
getcwd(3C) 
grep(1) 
awk(1) 
pause(2) 
pack(1) 
popen(3S) 
machid(1) 


getpeername(2N) 


uucheck(1M) 
mesg(1) 
mptx(5) 
ptx(1) 
acct(4) 
acctcms(1M) 
perror(3C) 
pa(1) 
more(1) 
pa(1) 
split(1) 
pipe(2) 
tee(1) 
popen(3S} 
fish(6) 
plock(2) 
plot(4) 
plot(3X) 
fseek(3S) 
Iseek(2) 
popen(3S) 
ar(1) 
basename(1) 
banner(1) 
exp(3M) 


/exponential, logarithm, 
bre, bcheckre, re, 


/monacct, nulladm, 
/nulladm, pretmp, 

text for/ ew, checkew: 
profile. monitor: 

cpp: the C language 
/determine C language 
file. unget: undoa 
profiler. 

prfld, prfstat, 

prfsnap, prfpr:/ 
/prfstat, prfdc, prfsnap, 
prfid, prfstat, prfde, 
prfpr: operating/ prfid, 
of/ gps: graphical 
types. types: 

window management 
hopefully/ fortune: 
prs: 

date: 

cal: 

count of a file. sum: 
editing activity. sact: 
manual. man, manprog: 
cat: concatenate and 


pr: 
of/ /vfprintf, vsprintf: 
/fprintf, sprintf: 
information. Ipstat: 
common object file. nm: 
CTIX system. uname: 
news: 

from proto file;/ qlist: 
blocks/ bcheck: 
acctcom: search and 
trpt: 

common object/ size: 
and names. id: 

mm, osdd, checkmm: 
Ip: parallel 

requests to an LP line 
a PT or GT local 
Ipset: set parallel line 
Ipr: line 

enable/disable LP 
sprintf: print/ 

run a command at low 
nice: change 

process/ renice: alter 
logged errors. errpt: 
acct; enable or disable 
acctprel, acctpre2: 
/search and print 
alarm: set a 

process/ times: get 
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power, square root/ . . 
powerfail, drvload:/ .. 
pr: print files. . . . 6 « 
pretmp, prdaily,/ ... 
prdaily, prtacct,/ .. . 
prepare constant-width 

prepare execution .. . 
preprocessor. . «+ +» 
preprocessor include/ . 
previous get of an SCCS 
prf: operating system. 
prfdc, prfsnap, prfpr:/ . 
prfld, prfstat, prfde, 
prfpr: operating system/ 
prfsnap, prfpr:/ 
prfstat, prfdc, prfsnap, . 
primitive string, format 

primitive system data . 
primitives. window: .. 
print arandom, .... 
print an SCCS file. . . 
print and set the date. . 
print calendar. .... 
print checksum and block 
print current SCCS file 

print entries in this 
print files. 
print files. 2... ee. 
print formatted output 

print formatted output. 

print LP status 
print name listof .. . 
print name of current . 
print news items. ... 
print out file lists ... 
print out the list of .. 
print process accounting/ 
print protocol trace. 
print section sizes of 
print user and group IDs 
print/check documents/ 
printer interface. 
printer. /send/cancel . 
printer. /or relocate . . 
printer options. ... » 
printer spooler. .... 
printers. /disable: . . . 
printf, fprintf, . 2... 
priority. nice: . 2 «6 « 
priority of a process. . . 
priority of running .. 
process areportof ... 
process accounting. . . 
process accounting. .. 
process accounting/ . . 
process alarm clock. . . 
process and child ... 


oe ee ee 


oe ee 
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exp(3M) 
bre(1M) 
pr(1) 
acctsh(1M) 
acctsh(1M) 
ew(1) 
monitor(3C) 
epp(1) 
includes(1) 
unget(1) 
prf(7) 
profiler(1M) 
profiler(1M) 
profiler(1M) 
profiler(1M) 
profiler(1M) 
gps(4) 
types(5) 
window(7) 
fortune(6) 
prs(1) 


vprintf(3S) 
printf(3S) 
Ipstat(1) 


- nm(1) 


uname(1) 
news(1) 
qlist(1) 
bcheck(1M) 
acctcom(1) 


Ipset(1M) 
Ipr(1) 
enable(1) 
printf(3S) 
nice(1) 
nice(2) 
renice(1) 
errpt(1M) 
acct(2) 
acct pre(1M) 
acctcom(1) 
alarm(2) 
times(2) 


/priority of running 
init, telinit: 

/time a command; report 
exit, exit: terminate 
fork: create a new 
/getppid: get process, 
setpgrp: set 

group, and parent 
script for the init 

kill: terminate a 
change priority of a 
kill: send a signal toa 
initiate pipe to/from a 
/getperp, getppid: get 
ps: report 

in memory. plock: lock 
get process and child 
wait: wait for child 
ptrace: 

pause: suspend 

await completion of 
/list of file systems 

@ process or a group of 
killall: kill all active 

or file/ fuser: identify 
/pattern scanning and 
halt: terminate all 
/interactive message 
m4: macro 

truth value about your 
data. 

function. 

profile. 

prof: display 

prepare execution 
profil: execution time 
environment at login/ 
function. prof: 

prf: operating system 
prfpr: operating system 
sadp: disk access 
/command 

/using the mkfs(1) 
/out file lists from 
/endprotoent: get 
Internet File Transfer 
telnetd: DARPA TELNET 
Trivial File Transfer 
user interface to TELNET 
to the DARPA TFTP 
trpt: print 
ACU/modem calling 
Internet protocols. 

list of Internet 

update: 

facts. arithmetic: 
/pdp1l, u3b, u3b5, vax: 
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process by changing/ . . 
process control/ ..... 
process data and system/ 

process. 
process. 2. 2. eee eee 
process group, and/ ... 
process group ID. .... 
process IDs. /process . . 
process. inittab: .... 
process, 2. 2s. se eeee 
process. nice: . ....-s 
process or a group of/ .. 
process. popen, pclose: . . 
process, process group,/ . 
process status. . « « «6 « 
process, text, or data .. 
process times. times: .. 
process to stop or/ ...- 
process trace. 2.» ee ee 
process until signal. ... 
process. wait: . . 2... 
processed by fsck. .... 
processes. /asignalto .. 
processes, se eevee 
processes using a file . . . 
processing language. . . + 
processing. shutdown, . . 
processing system. . . . « 
processor, se. se eae 
processor type. /provide . 
prof: display profile ... 
prof: profile withina . .. 
profil: execution time . . 
profiledata. .....- 
profile. monitor: ... 
profile. . . 2.2. eee ee 
profile: setting up an ar 
profile withina ....-. 
profiler, . 2. 2. ee eae 
profiler. /prfsnap, ...- 
profiler, . 2. ee eae 
programming language. . 
proto file database. ... 
proto file; set links/ ... 
protocolentry. .»...+.-s 
Protocol server. /DARPA 
protocol server. . . 6.» + 
Protocol server. /DARPA 
protocol. telnet: .... 
protocol. /interface .. . 
protocol trace. . 2 + «> 
protocols. Dialers: . . .- 
protocols: list of . ...- 
protocols. protocols: . . . 
provide disk/ .....- 
provide drillin number. 
provide truth value/ .. . 
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renice(1) 
init(1M) 
timex(1) 
exit(2) 
fork(2) 
getpid(2) 
setpgrp(2) 
getpid(2) 
inittab(4) 
kill(1) 

nice(2) 

kill(2) 
popen(3S) 
getpid(2) 
ps(1) 
plock(2) 
times(2) 
wait(2) 
ptrace(2) 
pause(2) 
wait(1) 
checklist(4) 
kill(2) 
killall(1M) 
fuser(1M) 
awk(1) 
shutdown(1M) 
mailx(1) 
m4(1) 
machid(1) 
prof(1) 
prof(5) 
profil(2) 
prof(1) 
monitor(3C) 
profil(2) 
profile(4) 
prof(5) 

pri(7) 
profiler(1M) 
sadp(1M) 
sh(1) 
qinstall(1) 
qlist(1) 
getprotoent(3N) 
ftpd(1NM) 
telnetd(1NM) 
tftpd(1NM) 
telnet(1N) 
tftp(1N) 
trpt(1NM) 
Dialers(5) 
protocols(4N) 
protocols(4N) 
update(1M) 
arithmetic(6) 
machid(1) 


true, false: 


/pretmp, prdaily, 
status. 

sxt: 

/uniformly distributed 
/install or relocate a 
download. tdl, gtd}, 


input stream. ungetc: 
putw: put character or/ 
put character or/ pute, 
value to environment. 
file entry. 

string on a stream. 
/getutid, getutline, 
pute, putchar, fputc, 
password/group file/ 
name. 

tape. 

qic: interface for 

verify software using/ 
lists from proto file; / 


tput: 

msgget: get message 
iperm: remove a message 
qsort: 

immune to hangups and 
knowledge. 
random-number/ 
fortune: print a 

rand, srand: simple 
fsplit: split FORTRAN, 
system/ bre, bcheckrc, 
command execution. 
ruserok: routines for/ 


getpass: 

table entry/ Idtbread: 
Idshread, Idnshread: 
read: 

send mail to users or 
line: 


of a member/ Idahread: 
acommon/ ldfhread: 

a common object file for 
open: open for 

Iseek: move 

memory/ malloc, free, 
mallopt,/ malloc, free, 
system. 

reboot: 

/specify what to do upon 
socket. recv, recvfrom: 
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provide truth values. . 
prs: print an SCCS file. 
prtacct, runacct,/ .. 
ps: report process .. - 
pseudo-device driver. . 
pseudo-random numbers. 
PT or GT local printer. 
ptdl: RS-232 terminal . 
ptrace: process trace. . 
ptx: permuted index. . 
push character back into 
pute, putchar, fpute, . . 
putchar, fputc, putw: . 
putenv: change or add . 
putpwent: write password 
puts, fputs: puta ... 
pututline, setutent,/ .. 
putw: put character or/ 
pwek, grpck: 2... e 
pwd: working directory 
qic: interface for QIC . 
QIC tape. .. 2.2 ee 
qinstall: install and . . 
qlist: print out file . .. 
qsort: quicker sort. . . 
query terminfo database. 
11 Pan a er a 
queue, semaphore set or/ 
quicker sort. ae 
quits. /run a command 
quiz: test your... 
rand, srand: simple 
random, hopefully/ 
random-number generator. 
ratfor, or eflfiles. ... 
re, powerfail, drvload:  . 
remd: remote shell . . . 
remd, rresyport, . . + « 
rep: remote file copy. + 
read a password. ... 
read an indexed symbol 
read an indexed/named/ 
read from file. .... 
read mail. mail, rmail: . 
read one line. . 2. 2. ee 
read: read from file. 
read the archive header 
read the file header of . 
reading. /ldaopen: open 
reading or writing. . . 
read/write file pointer. . 
realloc, calloc: main. . 
realloc, calloc, . . 2+. 
reboot: reboot the ... 
reboot the system. ... 
receipt of asignal. .. . 
receive a message from a 
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true(1) 
prs(1) 
acctsh(1M) 
ps(1) 

sxt(7) 
drand48(3C) 
mktpy(1) 
tdl(1) 
ptrace(2) 
ptx(1) 
ungetc(3S) 
putce(3S) 
pute(3S) 
puteny(3C) 
putpwent(3C) 
puts(3S) 
getut(3C) 
pute(3S) 
pwek(1M) 
pwd(1) 
qic(7) 

qic(7) 
qinstall(1) 
qlist(1) 
qsort(3C} 
tput(1) 
msgget(2) 
iperm(1) 
gsort(3C) 
nohup(1) 
quiz(6) 
rand(3C) 
fortune(6) 
rand(3C) 
fsplit(1) 
bre(1M) 
remd(1N) 
remd(3N) 
rep(1N) 
getpass(3C) 
ldt bread(3X) 
Idshread(3X) 
read(2) 
mail(1) 
line(1) 
read(2) 
Idahread(3X) 
Idfhread(3X) 
Idopen(3X) 
open(2) 
Iseek(2) 


reboot(1M) 
reboot(1M) 
signal(2) 
recv(2N) 


lockf: 

per-process accounting 
errdead: extract error 
connect accounting 
backup tape. frec: 

a message from a/ 
message from a/ recv, 
ed, 

and execute regular/ 
expression compile. 
/maintain, update, and 
execute regular/ regemp, 
expression compile and/ 
/exclusive access to 
compile and/ regexp: 
compile. regemp: 
/compile and execute 
requests. accept, 

two/ comm: select or 
lorder: find ordering 
operator. join: 
information for a/ 
mktpy, mvtpy: install or 
/\dnrseek: seek to 

for a common/ reloc: 
/fabs: floor, ceiling, 
calendar: 

uux: CTIX to CTIX 
returning a stream to a 
uuxqt: execute 

return stream to a 
rhosts: 

rexecd: 

rep: 

rlogin: 

rlogind: 

execution. remd: 

rshd: 

Uutry: try to contact a 
ct: spawn getty toa 
SCCS file. rmdel: 
semaphore set or/ iperm: 
unlink: 

disk. dismount: 
directories. rm, rmdir: 
and eqn/ deroff: 

of running process by/ 
check and interactive 
file. uniq: report 
clock: 

fsize: 

communication/ ipes: 
disk blocks. df: 

errpt: process a 

sadc: system activity 
timex: time a command; 
ps: 
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record locking on files. . 
records. /summary from 
records and status/ .. 
records. /manipulate . 
recover files froma .. 
recy, recvfrom: receive . 
recvfrom: receivea .. 
red: text editor, .... 
regcemp, regex: compile . 
regemp: regular .... 
regenerate groups of/ . 
regex: compile and .. . 
regexp: regular .... 
regions of afile. . ... 
regular expression .. . 
regular expression .. . 
regular expression. . .. 
reject: allow/prevent LP 
reject lines common to . 
relation for an object/ . 
relational database .. 
reloc: relocation .... 
relocatea PT orGT/ . 
relocation entries of a/ . 
relocation information . 
remainder, absolute/ . . 
reminder service. ... 
remote command/ .. . 
remote command. /for . 


remote command requests. 


remote command. rexec: 
remote equivalent users. 

remote execution server. 

remote file copy. ... 
remote login. ....-. 
remote login server. . . 
remote shell command . 
remote shell server. . . 
remote system with/ . . 
remote terminal. ... 
remove a delta from an 

remove a message queue, 
remove directory entry. 

remove exchangeable . . 
remove filesor .... 
remove nroff/troff, tbl, . 
renice: alter priority . . 
repair. /consistency . . 
repeated lines ina ... 
report CPU time used. . 
report file size. .... 
report inter-process .. 
report number of free . 
report of logged errors. . 
report package. /sa2, . 
report process data and/ 
report process status. . 
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lockf(3C) 
acctcms(1M) 
errdead(1M) 
fwtmp(1M) 
frec(1M) 


make(1 


regexp(5) 
locking(2) 
regexp(5) 
regemp(1) 
regcmp(3X) 
accept(1M) 
comm(1) 
lorder(1) 
join(1) 
reloc(4) 
mktpy(1) 
Idrseek(3X) 
reloc(4) 
floor(3M) 
calendar(1) 
uux(1C) 
remd(3N) 
uuxqt(1M) 
rexec(3N) 
rhosts(4N) 
rexecd(INM) 
rep(1N) 
rlogin(1N) 
rlogind(1NM) 
remd(1N) 
rshd(1NM) 
Uutry(1M) 
ct(1C) 
rmdel(1) 
iperm(1) 
unlink(2) 
dismount(1) 
rm(1) 
deroff(1) 
renice(1) 
fsck(1M) 
uniq(1) 
clock(3C) 
fsize(1) 
ipes(1) 
df(1M) 
errpt(1M) 
sar(1M) 
timex(1) 
ps(1) 


a file. uniq: 
sar: system activity 
fseek, rewind, ftell: 

move/ /start/stop the LP 
reject: allow/prevent LP 
scheduler and move 
syslocal: special system 
Ip, cancel: send/cancel 
execute remote command 
common/ Idgetname: 
value. abs: 

user. logname: 

remote command. rexec: 
environment/ geteny: 
call. stat: data 

/ruserok: routines for 
col: filter 

reposition a/ fseek, 
/create a new file or 

a remote command. 
server. 

equivalent users. 


server. 
or directories. 

users or read/ mail, 
from an SCCS file. 
directories. rm, 

chroot: change 
command. chroot: change 
/logarithm, power, square 
manipulate the routing/ 
/td: graphical device 
/rresvport, ruserok: 
address manipulation 
object file access 

compile and match 

table of contents 
manually manipulate the 
routines for/ remd, 
/terminal’s local 

tdl, gtdl, ptdl: 
standard/restricted/ sh, 
server. 

and stop terminal input/ 
priority. nice: 

hangups and/ nohup: 
runacct: 

accounting. 

/prdaily, prtacct, 

/alter priority of 

of nodes on local/ 

remd, rresvport, 

on local network. 

server, 

activity report/ 

activity report/ sal, 
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report repeated lines in rs 
reporter. .« 2. ee» ee « 
reposition a file/ 
request scheduler and .. 
requests. accept, 
requests. /LP request . . 
requests. «+ se ee eee 
requests to an LP line/ . . 
requests. uuxqt: oo aw 
retrieve symbol name for . 
return integer absolute . . 
return login nameof ... 
return stream toa .. se 
return value for ..... 
returned by stat system . 
returning a stream to a/ . 
reverse line-feeds. .... 
rewind, ftell: . 2... 2. 
rewrite an existing one. . 
rexec: return stream to . . 
rexecd: remote execution . 
rhosts: remote ..... 
rlogin: remote login. 
rlogind: remote login . . . 
rm, rmdir: remove files . . 
rmail: send mailto ... 
rmdel: remove a delta .. 
rmdir: remove files or 


root directory. ....-. 
root directory fora ... 
root functions. ..... 


route: manually .....- 
routines and filters. . . 
routines for returning a/ . 
routines. /Internet ... 
routines. Idfen: common . 
routines, /expression . 
routines. /graphical .. . 
routing tables. route: .«. . 
rresvport, ruserok: . . « 
RS-232 channels. ... - 
RS-232 terminal/ ... . 
rsh: shell, the ...... 
rshd: remote shell . .. . 
rsterm: manually start .. 
run acommand atlow .. 
run a command immune to 
run daily accounting. .. 
runacct: run daily .... 
runacct, shutacct,/  . . . 
running process by/ ... 
ruptime: display status . . 
ruserok: routines for/ . . 
rwho: who is logged in .. 
twhod: node status . . 
sal, sa2, sade: system. . 
sa2, sade: system 
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uniq(1) 
sar(1) 
fseek(3S) 
Ipsched(1M) 
accept(1M) 
Ipsched(1M) 
syslocal(2) 
Ip(1) 
uuxqt(1M) 
ldgetname(3X) 
abs(3C) 
logname(3X) 
rexec(3N) 
getenv(3C) 
stat(5) 
remd(3N) 
col(1) 
fseek(3S) 
creat(2) 
rexec(3N) 
rexecd(1NM) 
rhosts(4N) 
rlogin(1N) 
rlogind(INM) 
rm(1) 
mail(1) 
rmdel(1) 
rm(1) 
chroot(2) 
chroot(1M) 
exp(3M) 
route(1NM) 
gdev(1G) 
remd(3N) 
inet(3N) 
ldfen(4) 
regexp(5) 


. toc(1G) 


route(1NM) 
remd(3N) 
tp(7) 

tdl(1) 

sh(1) 
rshd(1NM) 
rsterm(1M) 
nice(1) 
nohup(1) 
runacct(1M) 
runacct(1M) 
acctsh(1M) 
renice(1) 
ruptime(1N) 
remd(3N) 
twho(1N) 
rwhod(1NM) 
sar(1M) 


. sar(1M) 


file editing activity. 
report/ sal, sa2, 
profiler. 

graph. 

reporter. 

segment space/ brk, 
convert formatted/ 
bfs: big file 

language. awk: pattern 
delta commentary of an 
comb: combine 

a delta (change) to an 
sact: print current 

get: get a version of an 
prs: print an 

remove a delta from an 
two versions of an 
secsfile: format of 

a previous get of an 
val: validate 

create and administer 
what: identify 

versions of an SCCS/ 
file. 

/the LP request 
system. uusched: the 
for a common object / 
clear: clear terminal 
ocurse: optimized 
curses: CRT 

display editor/ vi: 
process. inittab: 

of terminal session. 
initialization shell 


difference program. 
grep, egrep, fgrep: 
bsearch: binary 
accounting/ acctcom: 
Isearch, Ifind: linear 
hdestroy: manage hash 
twalk: manage binary 
common object/ senhdr: 
/read an indexed /named 
line number entries of a 
relocation entries of a 
/to an indexed/named 
object/ size: print 


/jrand48, srand48, 
ldsseek, ldnsseek: 
Idlseek, Idnlseek: 
Idrseek, ldnrseek: 

file header/ ldohseek: 
of a common/ Idtbseek: 
get shared memory 

brk, sbrk: change data 


5/86 


sact: print current SCCS sact(1) 
sadc: system activity . . . . sar(1M) 
sadp: disk access .. . . . sadp(1M) 
sag: system activity .. . . sag(1G) 
sar: system activity . .. . sar(1) 
sbrk: change data .. .. . brk(2) 
scanf, fscanf, sscanf: . . . . scanf(3S) 
scanner. 2 2 ee ee eee bfs(1) 
scanning and processing awk(1) 
SCCS delta. /change the . cde(1) 
SCCS deltas. . 2.2.2. comb(1) 
SCCS file. delta: make delta(1) 
SCCS file editing/ ..... sact(1) 
SCOS file. .. 2...» get(1) 
SCCS file ....-2 2 prs(1) 
SCCS file. rmdeli: . 2... rmdel(1) 
SCCS file. /compare . « scesdiff(1)} 
SCCS file. ....... « scesfile(4) 
SCCS file. unget: undo. . unget(1) 
SOCS file: 2) sawn val(1) 
SCCS files. admin: . . . . admin(1) 
SCCS files. . 2... 2 eee what(1)} 


secsdiff: compare two 
secsfile: format of SCCS . 
scheduler and move/ .. .« 
scheduler for the UUCP  . 
scnhdr: section header .. . 
SCTEEN. « «ee we ee oe 
screen functions. ....-. 
screen handling and/ . 
screen-oriented (visual) .. . 
script for the init ..... 
script: make typescript ... 
scripts. /system 
sdb: symbolic debugger. . 
sdiff: side-by-side ..... 
search afile fora/ ....+- 
search a sorted table. 
search and print process . . 
search and update. 

search tables. /hcreate, 
search trees. /tdelete, 
section header for a 

section header ofa/ ... 
section of a common/ /to 
section of a common/ /to 
section of a common/ 


oe ee 


- . sccsdiff(1) 
. scesfile(4) 

. Ipsched(1M) 

. uusched(1M) 


senhdr(4) 


ocurse(3X) 


. curses(3X) 


vi(1) 
inittab(4) 
script(1) 
bre(1M) 


. sdb(t) 


sdiff(1) 
grep(1) 


. bsearch(3C) 


acctcom(1) 


- lsearch(3C) 
. hsearch(3C) 
. tsearch(3C) 
- senhdr(4) 

. Idshread(3X) 
- Idiseek(3X) 
. Idrseek(3X) 
. Idsseek(3X) 


section sizes of common . size(1) 

sed: stream editor. ...- sed(1) 

seed 48, lcong48:/ .. +. ++ drand48(3C) 
seek toan/ . 2... eee Idsseek(3X) 
seek to line number/ . . . « Idlseek(3X) 
seek to relocation/ .... .- Idrseek(3X) 
seek to the optional . . . . Idohseek(3X) 


seek to the symbol table 
segment. shmeget: 
segment space/ 
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. Idtbseek(3X) 
. shmget(2) 


brk(2) 


common to two/ comm: 
greek: 

line of a/ cut: cut out 
object file. dump: dump 
operations. semctl: 
semop: 

/remove a message queue, 
semget: get set of 
control operations. 
semaphores. 

operations. 

socket. send, sendto: 
process or a/ kill: 

read mail. mail, rmail: 
message to a socket. 

an LP line/ Ip, cancel: 
to a socket. send, 
/attach and detach 

File Transfer Protocol 
rexecd: remote execution 
rlogind: remote login 
rshd: remote shell 
rwhod: node status 
DARPA TELNET protocol 
File Transfer Protocol 
uucpd: network uucp 
typescript of terminal 
Internet address from/ 
buffering to a stream. 
address on disk. 

group IDs. setuid, 
/getgrgid, getgrnam, 
get/ /gethostbyname, 
non-local goto. 

generate hashing/ crypt, 
table. 

get/ /getnetbyname, 
group ID. 
/getprotobyname, 
/getpwuid, getpwnam, 
get/ /getservbyname, 
options on/ getsockopt, 
environment/ cprofile: 
environment at/ profile: 
/speed and terminal 

and group IDs. 

system. 

/getutline, pututline, 
buffering to a/ setbuf, 
integer data in/ sputl, 
standard/restricted/ 
xstr: extract and 
operations. shmcetl: 
/queue, semaphore set or 
operations. shmop: 
shmget: get 

remd: remote 


5/86 


select or reject lines . .. 
select terminal filter. . . . 
selected fields of each .. 
selected partsofan ... 
semaphore control . .. - 
semaphore operations. . . 
semaphore set or shared/ . 
semaphores. . 2... => 
semctl: semaphore ... . 
semget: get setof .... 
semop: semaphore ... .« 
send a messagetoa ... 
send asignaltoa .... 
send mail to usersor .. . 
send, sendto: senda ... 
send/cancel requests to. 
sendto: send a message . . 
serial lines as network/ 
server. /DARPA Internet 

server. 
server. 
server. 
server, . ee we 
server. telnetd: ..... 
server. /DARPA Trivial . 
SOPVETY, se eke ie: tees eee 
session. script: make .. 
setaddr: set DARPA ... 
setbuf, setvbuf: assign . . 
setenet: write Ethernet . 
setgid: set userand .. 
setgrent, endgrent,/ .. 
sethostent, endhostent: . 
setjmp, longjmp: 
setkey, encrypt: . 2... « 
setmnt: establish mount . 
setnetent, endnetent: .. 
setpgrp: set process .. « 
setprotoent,/ . . + .+- 
setpwent, endpwent,/ .. 
setservent, endservent: . . 
setsockopt: get and set .. 
setting upaCshell ... 
setting up an 2. eee ee 
settings used by getty. . . 
setuid, setgid: set user . . 
setuname: set name of .. 
setutent, endutent,/ .. . 
setvbuf: assign . . 2. 2 « 
sgetl: access long .. + - 
sh, rsh: shell, the .... 
share stringsinC/ ... 
shared memory control . . 
shared memory id. .... 
shared memory .« 2 «es 
shared memory segment. . 
shell command execution. 


ee © © we ew we ew 
re 
ee © © © ew oe 
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comm(1) 
greek(1) 
cut(t) 
dump(1) 
semctl(2) 
semop(2) 
iperm(1) 
semget(2) 
semctl(2) 
semget(2) 
semop(2) 


send(2N) 
slattach(1NM) 
ftpd(1NM) 
rexecd(1NM) 
riogind(1NM) 
rshd(INM) 
rwhod(1NM) 
telnetd(1NM) 
tftpd(1NM) 
uucpd(1NM) 
script(1) 
setaddr(1NM) 
setbuf(3S) 
setenet(1NM) 
setuid(2) 
getgrent(3C) 
gethostent(3N) 
setjmp(3C) 
erypt(3C) 
setmnt(1M) 
getnetent(3N) 
set pgrp(2) 
getprotoent(3N) 
getpwent(3C) 
getservent(3N) 
getsockopt(2N) 
eprofile(4) 
profile(4) 
getty defs(4) 
setuid(2) 
setuname(1M) 
getut(3C) 
setbuf(3S) 
sputl(3X) 
sh(1) 

xstr(1) 
shmctl(2) 
iperm(1) 
shmop(2) 
shmget(2) 
remd(1N) 


interpreter)/ csh: a 
system: issue a 

eprofile: setting up a C 
shl: 

/startup, turnacct: 
system initialization 
rshd: remote 

sh, rsh: 

manager. 

control operations. 
memory segment. 
operations. 
full-duplex/ shutdown: 
/prtacct, runacct, 
terminate all/ 

of a full-duplex/ 
program. sdiff: 

login: 

suspend process until 
to do upon receipt of a 
do upon receipt of a/ 
group of/ kill: send a 
gsignal: software 
/generate programs for 
generator. rand, srand: 
acos, atan, atan2:/ 
hyperbolic functions. 
fsize: report file 

sizes of common object / 
size: print section 
attach and detach/ 
detach serial/ slattach, 
for an interval. 

for interval. 

view graphs, and 

view graphs and 

the/ ttyslot: find the 
spline: interpolate 
accept a connection on a 
bind: bind a name toa 
a connection on a 
endpoint for/ 

for connections on a 
getsockname: get 
receive a message from a 
send a message to a 
get and set options on 
/file perusal filter for 
ctinstall: install 

ssignal, gsignal: 

/install and verify 

sort: 

qsort: quicker 

files. 

tsort: topological 

lines common to two 
bsearch: binary search a 
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shell (command ....- 
shellcommand. ..... 
shell environment at/ .. 
shell layer manager. . . . 
shell procedures for/ . . 
shell scripts. /drvload: . . 
shell server. 
shell, the/ .....2.-. 
shi: shell layer ..... 
shmctl: shared memory. 
shmget: get shared ... 
shmop: shared memory . . 
shut down partofa ... 
shutacct, startup,/ .. . 
shutdown, halt: ..... 
shutdown: shut down part 
side-by-side difference .. 
Signon. ...2 esses 
signal. pause: . 2... 
signal. /specify what .. 
signal: specify what to .. 
signal to a process ora . . 
signals. ssignal, ..... 
simple lexical tasks. ... 
simple random-number . . 
sin, cos, tan, asin, .... 
sinh, cosh,tanh: .... 
S120.) Sel Series eo Bes 
size: print section .... 
sizes of common object/ . 
slattach, sldetach: .... 
sldetach: attach and ... 
sleep: suspend execution . 
sleep: suspend execution . 
slides. /documents, .. . 
slides. /for typesetting . . 
slot in the utmp file of 
smooth curve. 
socket. 
socket. . 2 2. eee ee 
socket. /initiate .... 
socket: create an . . 2 e 
socket. listen: listen .. . 
socket name. . «+ ea e 
socket. recy, recvfrom: . . 
socket. send, sendto: .. 
sockets. /setsockopt: . . 
soft-copy terminals. ... 
software. . 2. 2 ese ee 
software signals. .... 
software using the/ ... 
sort and/or merge files. . 
Sort. 2 2 6 ee ee ew ew 
sort: sort and/or merge. 
Sort. 2 2 2 ee es we ew 
sorted files. /or reject . . 
sorted table. 


accept: . «6 « « 
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esh(1) 
system(3S) 
eprofile(4) 
shi{1) 
acctsh(1M) 
bre(1M) 
rshd(1NM) 
sh(1) 

shl(1) 
shmctl(2) 
shmget(2) 
shmop(2) 
shutdown(2N) 
acctsh(1M) 
shutdown(1M) 
shutdown(2N) 
sdiff(1) 
login(1) 
pause(2) 
signal(2) 
signal(2) 
kill(2) 
ssignal(3C) 
lex(1) 
rand(3C) 
trig(3M) 
sinh(3M) 
fsize(1) 

size(1) 

size(1) 
slattach(1NM) 
slattach(1NM) 
sleep(1) 
sleep(3C) 
mmt(1) 

my(5) 
ttyslot(3C) 
spline(1G) 
accept(2N) 
bind(2N) 
connect(2N) 
socket(2N) 
listen(2N) 
getsockname(2N) 
recv(2N) 
send(2N) 
getsockopt(2N) 
pg(1) 
ctinstall(1) 
ssignal(3C) 
qinstall(1) 
sort(1) 
qsort(3C) 
sort(1) 

tsort(1) 
comm(1) 
bsearch(3C) 


change data segment 
/unexpand: expand tabs to 
terminal. ct: 

files. fspec: format 
openi: open a file 
receipt of a/ signal: 
terminal type, modes, 
terminal type, modes, 
settings/ gettydefs: 
spellin, hashcheck:/ 
spell, hashmake, 
/spellin, hashcheck: find 
smooth curve. 

Pieces. split: 

esplit: context 

or efl files. fsplit: 
Pieces. 

uucleanup: uucp 

Ipr: line printer 
/configure the LP 
printf, fprintf, 

long integer data in a/ 
exp, log, log10, pow, 
/logarithm, power, 
random-number/ rand, 
/mrand48, jrand48, 
scanf, fscanf, 

software signals. 
input/output/ stdio: 
communication/ ftok: 
sh, rsh: shell, the 
input/ rsterm: manually 
Ipsched, Ipshut, Ipmove: 
/runacct, shutacct, 

stat system call. 

status. 

network useful with/ 
stat: data returned by 
useful with/ stat: 

/list file names and 
ustat: get file system 
dump. /error records and 
\pstat: print LP 
clearerr, fileno: stream 
control. uustat: uucp 
communication facilities 
netstat: show network 
ruptime: display 

ps: report process 
rwhod: node 

stat, fstat: get file 
input/output package. 


for child process to 
/manually start and 
strnemp, strepy,/ 
/strepy, strnepy, strlen, 
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space allocation. /sbrk: 
spaces, and vice versa. . 
spawn getty to a remote 
specification in text . . 
specified by i-node. .. 
specify what ta do upon 
speed, and line/ /set . 
speed, and line/ /set . 
speed and terminal .. 
spell, hashmake, ... » 
spellin, hashcheck: find/ 
spelling errors. 
spline: interpolate 
split afileinto .... 
split. «2 2. ee ee we 
split FORTRAN, ratfor, 
split: split a file into . . 
spool directory/ ... . 
spooler. 


ee e eo we ee 


spooling system. ....-s 


sprintf: print formatted / 
sputl, sgetl: access . . . 
sqrt: exponential,/ .. . 
square root functions. . 
srand: simple ..... 
srand48, seed48,/ ... 
sscanf: convert/ ...- 
ssignal, gsignal: .... 
standard buffered ... 
standard interprocess . 
standard/restricted/ . . 
start and stop terminal 

start/stop the LP/ . . 
startup, turnacct: shell/ 

stat: data returned by . 
stat, fstat: get file ... 
stat: statistical . 2... 
stat system call. . ... 
statistical network . . . 
statistics forafile/  . . 
statistics. . 2 2 2. ee 
status information from 

status information. .. 
status inquiries. /feof, . 
status inquiry and job . 
status. /inter-process . 
status. 2. 2. 2 e ee ee 
status of nodes on local/ 
Status. 2. 2 ee ee ee 
status server. 
status. 
stdio: standard buffered 
stime: set time. . . +. 
stop or terminate. /wait 
stop terminal input and/ 
streat, strncat, strcmp, . 
strehr, strrehr,/ 
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brk(2) 
expand(1) 
et(1C) 
fspec(4) 
openi(2) 
signal(2) 
getty(1M) 
uugetty(1M) 
getty defs(4) 
spell(1) 
spell(1) 
spell(1) 
spline(1G) 
split(1) 
esplit(1) 
fsplit(1) 
split(1) 
uucleanup(1M) 
Ipr(1) 
Ipadmin(1M) 
printf(3S) 
sputl(3X) 
exp(3M) 
exp(3M) 
rand(3C) 
drand48(3C) 
scanf(3S) 
ssignal(3C) 
stdio(3S) 
stdipe(3C) 
sh(1} 
rsterm(1M) 
Ipsched(1M) 
acctsh(1M) 
stat(5) 
stat(2) 
stat(1G) 
stat(5) 
stat(1G) 
ff(1M) 
ustat(2) 
errdead(1M) 
Ipstat(1) 
ferror(3S) 
uustat(1C) 
ipes(1) 
netstat(1N) 
ruptime(1N) 
ps(1) 
rwhod(1NM) 
stat(2) 
stdio(3S) 
stime(2) 
wait(2) 
rsterm(1M) 
string(3C) 
string(3C) 


strcat, strncat, 

/stremp, strnemp, 
/strpbrk, strspn, 

sed: 

fflush: close or flush a 
freopen, fdopen: open a 
a file pointer ina 
character or word from a 
get a string froma 
character or word on a 
fputs: put a string on a 
assign buffering to a 
/feof, clearerr, fileno: 
/routines for returning a 
command. rexec: return 
back into input 

and base-64 ASCII 
convert date and time to 
floating-point number to 
gps: graphical primitive 
gets, fgets: get a 

puts, fputs: put a 
/strspn, strespn, strtok: 
strtod, atof: convert 
atof: convert ASCII 
/atol, atoi: convert 
ASCII text strings in a/ 
/extract the ASCII text 
xstr: extract and share 
line number information/ 
number/ strip: 

/strepy, strnepy, 
strnemp,/ strcat, 
strceat, strncat, strcmp, 
/stremp, strnemp, strepy, 
/strlen, strchr, strrchr, 
/strnepy, strlen, strchr, 
/strrchr, strpbrk, 

string to/ 

strspn, strespn, 

convert string to/ 

using a file or file 

for a terminal. 

another user. 

intro: introduction to 
plot: graphics interface 
/of several files or 

block count of a file. 

du: 

acctcms: command 
syne: update the 

syne: update 

user. su: become 
interval. sleep: 

interval. sleep: 

signal. pause: 
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stremp, strnemp, strepy,/ 

strepy, strnepy, strlen,/ . 
strespn, strtok: string/ . . 
stream editor. 
stream. 
stream. 
stream. 
stream. 
stream. 
stream. 


felose, ... 
fopen, .. 2. 
/reposition ... 


gets, fgets: . 2. 
/putw: put ... 
stream. puts, . ...e-. 
stream. /setvbuf: ... . 
stream status inquiries. . 
stream toaremote/ .. . 
stream to aremote ... 
stream. /push character . 
string. /long integer... 
string. /asctime, tzset: . . 
string. /gevt: convert .. 
string, format off .... 
string from a stream. eo. 
string onastream. ... 
string operations. .... 
string tof .....e- 
string to floating-point/ . 
string tointeger. . . 6 
strings: extract the ... 
strings in a file. 
strings in C programs. . . 
strip: strip symbol and . . 
strip symbol and line .. 
strlen, strchr, strrehr,/ . . 
strneat, stremp, . 2. . «+ 
strnemp, strepy,/ ...- 
strncpy, strlen, strchr,/  . 
strpbrk, strspn,/ ... - 
strrehr, strpbrk,/ .. + « 
strspn, strespn, strtok:/ . 
strtod, atof: convert ... 
strtok: string/ /strpbrk, . 
strtol, atol, atoi: . 2... 
structure. /processes . 
stty: set the options ... 
su: become super-user or . 
subroutines and/ .... 
subroutines. 2... 2 ee 
subsequent lines of one/  .« 
sum: print checksum and . 
summarize disk usage. . . 
summary from per-process/ 
super block. 
super-block. 
super-user or another .. 
suspend execution for an . 
suspend execution for .. 
suspend process until . . 
swab: swap bytes. ... 
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/getwi get 2.2... 


string(3C) 
string(3C) 
string(3C) 
sed(1) 
fclose(3S) 
fopen(3S) 
fseek(3S) 
getc(3S) 
gets(3S) 
putc(3S) 
puts(3S ) 
setbuf(3S) 
ferror(3S) 
remd(3N) 
rexec(3N) 
ungete(3S) 
a641(3C) 
ctime(3C) 
ecvt(3C) 
gps(4) 
gets(3S) 
puts(3S) 
string(3C) 
strtod(3C) 
atof(3C) 
strtol{3C) 
strings(1) 
strings(1) 
xstr(1)} 
strip(1) 
strip(1) 
string(3C) 
string(3 


( 
( 
( 
string( 
( 
( 


strtod(3C) 


du(1) 
acctems(1M) 
syne(1) 
sync(2) 

su(1) 
sleep(1) 
sleep(3C) 
pause(2) 
swab(3C) 


interface. swap: 

swab: 

administrative/ 

write on a file. 

driver. 

strip: strip 

Idgetname: retrieve 

/for common object file 
/compute the index of a 
common/ /read an indexed 
syms: common object file 
Idtbseek: seek to the 
sdb: 

symbol table format. 
super-block. 

block. 

update: provide disk 
file. swrite: 

interpreter) with C-like 
system/ perror, errno, 
requests. 

/errno, sys_errlist, 
binary search a sorted 
object file symbol 

/the index of a symbol 
/read an indexed symbol 
object file symbol 
device information 
mounted file system 
/seek to the symbol 

toc: graphical 

setmnt: establish mount 
troff. tbl: format 
manage hash search 
manipulate the routing 
tabs: set 

terminal. 

expand, unexpand: expand 
ctags: create a 

part of a file. 

atan2:/ sin, cos, 
functions. sinh, cosh, 
Xylogics 772 half-inch 
tar: 

files from a backup 

qic: interface for QIC 


for simple lexical 
/remove nroff/troff, 
nroff or troff. 

/erase, hardcopy, tekset, 
binary/ tsearch, tfind, 
terminal download. 


hpd, erase, hardcopy, 


4014: paginator for the 
initialization. init, 


5/86 


swap administrative .... 
swap bytes. 
swap: SWap 2. + eee eee 
swrite: synchronous ... . 
sxt: pseudo-device .. 2... 
symbol and line number/ . . 
symbol name for common/ . 
symbol table entry. .... 
symbol table entry of af .. 
symbol table entry ofa .. 
symbol table format. . ... 
symbol table of acommon/ . 
symbolic debugger. .... 
syms: common object file . . 
sync: update .... eee 
sync: update the super .. . 
synchronization. ...... 
synchronous writeona .. 
syntax. /shell (command .. 
sys_errlist, syS_nerr: . ... 
syslocal: special system ... 
sys_nerr: system error/ . . . 
table. bsearch: .....-. 
table entry. /for common . 
table entry of acommon/ . 
table entry of acommon/ . 
table format. /common .. 
table. master: master .. . 
table. mnttab: ...... 
table of a common object/ . 
table of contents/ ..... 
table. . 2 ee ee ew a 
tables for nroffor ..... 
tables. /hdestroy: .... . 
tables. route: manually .. 
tabs on aterminal. .... 
tabs: set tabs ona ..... 
tabs to spaces, and vice/ . . 
tags file. 2. 2. 2 ee es eee 
tail: deliver the last . ... 
tan, asin, acos, atan, »« ... 
tanh: hyperbolic ...... 
tape controller. /for .... 
tape file archiver. . 2... 
tape. frec: recover .. .s- 
tape. « 6 « © ee ew we ww 
tar: tape file archiver. ... 
tasks. /programs ..... 
tbl, and eqn constructs. .. 
tbl: format tablesfor ... 
td: graphical device/ . .. . 
tdelete, twalk: manage ... 
tdl, gtdl, ptdl: RS-232 ... 
tee: pipe fitting. 
tekset, td: graphical/ ... 
TEKTRONIX 4014 terminal. 
telinit: process control ... 
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swap(1M) 
swab(3C) 
swap(1M) 
swrite(2) 
sxt(7) 
strip(1) 
Idgetname(3X) 
ldgetname(3X) 
ldtbindex(3X) 
ldtbread(3X) 
syms(4) 
Idtbseek(3X) 
sdb(1) 
syms(4) 
sync(2) 
syne(1) 
update(1M) 
swrite(2) 
esh(1)} 
perror(3C) 
syslocal(2) 
perror(3C) 
bsearch(3C) 
Idgetname(3X) 
ldtbindex(3X) 
ldtbread(3X) 
syms(4) 
master(4) 
mnttab(4) 
Idtbseek(3X) 
toc(1G) 
setmnt(1M) 
tbl(1) 
hsearch(3C) 
route(1NM) 
tabs(1) 
tabs(1) 
expand(1) 
ctags(1) 
tail(1) 
trig(3M) 
sinh(3M) 
xmset{1M) 
tar(1) 
frec(1M) 
gie(7) 

tar(1) 

lex(1) 
deroff(1) 
tbl(1) 
gdev(1G) 
tsearch(3C) 
tdl(1) 

tee(1) 
gdev(1G) 
4014(1) 
init(1M) 


telnetd: DARPA 

/user interface to 

to TELNET protocol. 
protocol server. 

for a temporary/ tmpnam, 
tmpfile: create a 

/create a name for a 

for terminals. 

term: format of compiled 
term file.. 

capability data base. 

for the TEKTRONIX 4014 
of the DASI 450 
interface. tiop: 

base. termcap: 

base. terminfo: 

console: console 

spawn getty to a remote 
generate file name for 
tdl, gtdl, ptdl: RS-232 
/terminal inteface, and 
greek: select 

/tgetstr, tgoto, tputs: 
/manually start and stop 
tset: set terminal, 
termio: general 

tty: controlling 

establish an out-going 

of terminal types by 
clear: clear 

/make typescript of 

by/ gettydefs: speed and 
set the options for a 
tabs: set tabs on a 
inteface, and/ tset: set 
conlocate: locate a 

tty: get the name of the 
isatty: find name of a 
speed, and/ getty: set 
speed, and/ uugetty: set 
ttytype: list of 

vt: virtual 

of DASI 300 and 300s 
HP 2640 and 2621-series 
tp: controlling 

filter for soft-copy 
conventional names for 
kill: 

shutdown, halt: 

exit, _exit: 

error-logging/ errstop: 
child process to stop or 
tic: 

tput: query 

capability data base. 
interface. 

evaluation command. 
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TELNET protocol server. 
TELNET protocol. .. 
telnet: user interface . . 
telnetd: DARPA TELNET 
tempnam: create a name 

temporary file. 
temporary file. .... 
term: conventional names 
term file. 2... eee 
term: format of compiled 
termcap: terminal ... 
terminal. /paginator . 
terminal. /functions . . 
terminal accelerator . . 
terminal capability data 
terminal capability data 
terminal. ......-s 
terminal. ct: . 2. 2. 
terminal. ctermid: . . . 
terminal download. . . 
terminal environment. . 
terminal filter. .... 
terminal independent/ . 
terminal input and/ . . 
terminal inteface, and/ . 
terminal interface. . . . 
terminal interface... . 
terminal line/ dial: .. 
terminal number. /list . 
terminal screen. . . « + 
terminal session. ... 
terminal settings used . 
terminal. stty: .... 
terminal. .....2.-. 
terminal, terminal . . . 
terminal to use as the/ . 
terminal. ... 2... 
terminal. ttyname, .. 
terminal type, modes, . 
terminal type, modes, . 
terminal types by/ .. 
terminal. . 2... eee 
terminals. /functions . 
terminals. /functions of 
terminal’s local RS-232/ 
terminals. /file perusal 

terminals. term: .. . 
terminate a process. .. 
terminate all/ ..... 
terminate process. 
terminate the 
terminate. /wait for . . 
terminfo compiler. . . . 
terminfo database. .. 
terminfo: terminal 
termio: general terminal 
test: condition 
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telnetd(1NM) 
telnet(1N) 
telnet(1N) 
telnetd(1NM) 
tmpnam(3S) 
tmpfile(3S) 
tmpnam(3S) 
term(5) 
term(4) 
term(4) 
termcap(4) 
4014(1) 


'450(1) 


tiop(7) 
termcap(4) 
terminfo(4) 
console(7) 
et(1C) 
etermid(3S) 
tdl(1) 

tset(1) 
greek(1) 
termcap(3X) 
rsterm(1M) 
tset(1) 
termio(7) 
tty(7) 
dial(3C) 
ttytype(4) 
clear(1) 
script(1) 
getty defs(4) 
stty(1) 
tabs(1) 
tset(1) 
conlocate(1M) 
tty(1) 
ttyname(3C) 
getty(1M) 
uugetty(1M) 
ttytype(4) 
vt(7) 

300(1) 

hp(1) 

tp(7) 

pg(1) 
term(5) 
kill(1) 
shutdown(1M) 
exit(2) 
errstop(1M) 
wait(2) 
tic(1M) 
tput(1) 
terminfo(4) 
termio(7) 
test(1) 


quiz: 

ed, red: 

ex: 

ex for casual/ edit: 
change the format of a 
format specification in 
/format mathematical 
/prepare constant-width 
nroff: format 

plock: lock process, 
more, page: 

/extract the ASCII 
troff: typeset 

manage binary/ tsearch, 
interface to the DARPA 
the DARPA TFTP/ 
File Transfer Protocol / 
tgetflag, tgetstr,/ 
tgetent, tgetnum, 
tgetstr,/ tgetent, 
/tgetnum, tgetflag, 
/tgetflag, tgetstr, 


ttt, cubic: 

process data and/ timex: 
time: 

commands at a later 
environment at login 

for optimal access 


profil: execution 
an environment at login 
stime: set 


time: get 

/taset: convert date and 
clock: report CPU 

TZ: 

child process times. 
access and modification 
and child process 

access and modification 
report process data and/ 
accelerator interface. 
temporary file. 

a name for a temporary/ 
/_toupper, _tolower, 
contents routines. 
/pelose: initiate pipe 
/tolower, _toupper, 
_tolower,/ toupper, 
tsort: 

acctmerg: merge or add 
modification times of a/ 
toupper, tolower, 
_toupper, _tolower,/ 
terminal’s local RS-232/ 


5/86 


test your knowledge. . . 
text editor. 
text editor. 
text editor (variant of . 
text file. newform: .. 
text files. fspec: . 2... 
text for nroff or troff. . 
text for troff. 
text. 2. ee we we wee 
text, or data in memory. 
text perusal. 
text strings ina file. . . 
text. . 2. 2 2 ce we we eo 
tfind, tdelete, twalk: .. 
TFTP protocol. /user . 
tftp: user interface to. 
tftpd: DARPA Trivial . 
tgetent, tgetnum, ... 
tgetflag, tgetstr,/ .. . 
tgetnum, tgetflag, ... 
tgetstr, tgoto, tputs:/ . 
tgoto, tputs: terminal/ . 
tic: terminfo compiler. . 
tic-tac-toe. 2. 2. ee ee 
time a command; report 
time acommand. ... 
time. /batch: execute . 
time. /upaC shell .. 
time. /copy file systems 
time: get time. 
time profile. . . 2. 
time. /setting up .. - 
time. 2. ese ceecee 
time: time a command. . 
time. 2. 2 ee eee 
time to string. .... 
time used. . 2. ee 
time zone file. . 2. 2. 
times: get process and. 
times of a file. /update 

times. /get process . . 
times. utime: set file . 
timex: time a command; 

tiop: terminal . ... 
tmpfile: createa .... 
tmpnham, tempnam: create 
toascii: translate/ .. . 
toc: graphical table of . 
to/from a process. . . . 
_tolower, toascii:/ ... 
tolower, _toupper, ... 
topological sort. . 2. « 
total accounting files. . 
touch: update access and 
_toupper, _tolower,/ . . 
toupper, tolower, 
tp: controlling 
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quiz(6) 
ed(1) 

ex(1) 

edit(1) 
newform(1) 
fspec(4) 
eqn(1} 
ew(1) 
nroff(1) 
plock(2) 
more(1) 
strings(1) 
troff(1) 
tsearch(3C) 
tftp(1N) 
tftp(1N) 
tftpd(1NM) 
termeap(3X) 
termcap(3X) 
termcap(3X) 
termcap(3X) 
termcap(3X} 
tic(1M) 


at(1) 
eprofile(4) 
dcopy(1M) 
time(2) 
profil(2) 
profile(4) 
stime(2) 
time(1) 
time(2) 
ctime(3C) 
clock(3C) 


tiop(7) 
tmpfile(3S) 
tmpnam(3S) 
conv(3C) 
toc(1G) 
popen(3S) 
cony(3C) 
conv(3C) 
tsort(1) 
acctmerg(1M) 
touch(1)} 
conv(3C} 
conv(3C) 
tp(7) 


database. 

/tgetstr, tgoto, 
characters. 

ptrace: process 

trpt: print protocol 

ftp: file 

DARPA Internet File 
/DARPA Trivial File 
/tolower, toascii: 

tr: 

ftw: walk a file 

manage binary search 
trk: 

/asin, acos, atan, atan2: 
Protocol/ tftpd: DARPA 


constant-width text for 
text for nroff or 
typesetting view/ mv: a 
tables for nroff or 


trace. 

truth values. 

/u3b, u3b5, vax: provide 
true, false: provide 
system with/ Uutry: 
twalk: manage binary / 
terminal inteface, and/ 


terminal interface. 
terminal. 

name of a terminal. 

in the utmp file of the/ 
terminal types by/ 

/a loadable driver for 
/shutacct, startup, 
tsearch, tfind, tdelete, 
file: determine file 

about your processor 
getty: set terminal 
uugetty: set terminal 
/list of terminal 

data types. 

primitive system data 
session. script: make 
graphs, and/ mmt, mvt: 
troff: 

/troff macro package for 


time/ /gmtime, asctime, 
truth/ mc68k, pdpll, 
mc68k, pdpll, u3b, 
getpw: get name from 


limits. 
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tplot: graphics filters. . 
tput: query terminfo . . 
tputs: terminal/ .... 
tr: translate 
trace. 
trace. . 2 oe ee eo 
transfer program. ... 
Transfer Protocol/ 
Transfer Protocol/ . . 
translate characters. . . 
translate characters. . . 
TPO. ee ee ee ie 
trees. /tdelete, twalk: . 
trekkie game. . 2... 
trigonometric functions. 

Trivial File Transfer . . 
trk: trekkie game. . .. 
troff. /checkew: prepare 
troff. /mathematical . 
troff macro package for 

troff. tbl: format ... 
troff: typeset text. . . . 
trpt: print protocol .. 
true, false: provide . . 
truth value about your/ 
truth values. ..... 
try to contact a remote 

tsearch, tfind, tdelete, . 
tset: set terminal, ... 
tsort: topological sort. . 
ttt, cubic: tic-tac-toe. 
tty: controlling .... 
tty: get the name of the 


ttyname, isatty: find . .. 


ttyslot: find the slot . . 
ttytype: list of .... 
tunable variables. . . . 
turnacct: shell/ 2... 
twalk: manage binary/ . 
type. 
type. /truth value .. 
type, modes, speed, and/ 
type, modes, speed, and/ 
types by terminal/ 
types: primitive system 
types. types: 
typescript of terminal . 
typeset documents, view 

typeset text. . 2 « «© & 
typesetting view graphs/ 
TZ: time zone file. . . . 
tzset: convert date and . 
u3b, u3b5, vax: provide 

u3b5, vax: provide truth/ 
UD. 


ul: do underlining. . ... 


ulimit: get and set user 
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tplot(1G) 
tput(1) 
termcap(3X) 
tr(1) 
ptrace(2) 
trpt(1NM) 
ftp(1N) 
ftpd(1NM) 
tftpd(INM) 
conv(3C) 
tr(1) 
ftw(3C) 
tsearch(3C) 
trk(6) 


true(1) 
Uutry(1M) 
tsearch(3C) 
tset(1) 
tsort(1) 
ttt(6) 

tty(7 

tty(1 
ttyname(3C) 
ttyslot(3C) 
ttytype(4) 
mktunedry(1M) 
acctsh(1M) 
tsearch(3C) 
file(1) 
machid(1) 
getty(1M) 
uugetty(1M) 
ttytype(4) 
types(5) 
types(5) 
script(1) 
mmt(1) 


) 
machid(1) 
machid(1) 
getpw(3C) 
ul({1) 
ulimit(2) 


creation mask. 

mode mask. 

dismount file/ mount, 
system. 

current CTIX system. 
current CTIX system. 
ul: do 

an SCCS file. unget: 
spaces, and/ expand, 
get of an SCCS file. 
back into input stream. 
/\cong48: generate 
lines in a file. 

mktemp: make a 
program. 

and unlink system/ link, 
entry. 

/exercise link and 
umount: 

expand/ pack, peat, 
modification/ touch: 
groups/ make: maintain, 
Ifind: linear search and 
synchronization. 

syne: 

syne: 

du: summarize disk 
/statistical network 
names. id: print 
setuid, setgid: set 
crontab - 

login name of the 

real/ /getegid: get real 
environ: 

protocol. telnet: 
DARPA TFTP/ tftp: 
ulimit: get and set 
return login name of 
/get real user, effective 
super-user or another 
utmp file of the current 
write: write to another 
of ex for casual 

/rmail: send mail to 
remote equivalent 
wall: write to all 
/identify processes 
/and verify software 
statistics. 

gutil: graphical 

and modification times. 
formats. utmp, wtmp: 
/utmpname: access 
/find the slot in the 
wtmp entry formats. 
/setutent, endutent, 
directories and/ 
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umask: set and get file . 
umask: set file-creation . 
umount: mount and . . 
umount: unmount a file 
uname: get nameof . . 
uname: print name of . 
underlining. .... 
undo 2 previous get of . 
unexpand: expand tabs to 
unget: undo a previous . 
ungetc: push character . 
uniformly distributed/ . 
uniq: report repeated . 
unique filename. .. . 
units: conversion .. . 
unlink: exercise link . . 
unlink: remove directory 
unlink system calls. .. 
unmount a file system. . 
unpack: compress and . 
update access and ... 
update, and regenerate . 
update. Isearch, . . . « 
update: provide disk . 
update super-block. . 
update the super block. 
usage. 2. 6 ee ee ee 
useful with graphical/ . 
user and group IDs and 
user and group IDs. . . 
user crontab file. . . . 
user. /get character . . 
user, effective user, . . 
user environment. ... 
user interface to TELNET 
user interface tothe . . 
user limits. 
user. logname: ... + 
user, real group, and/ . 
user. su: become .. » 
user. /the slot inthe . 
USCR. ete. ee we else te oe 
users). /editor (variant 
users or read mail. . . . 
users. rhosts: 
users. 2 oe es ee ee 
using a file or file/ . . . 
using the mkfs(1) proto/ 
ustat: get file system . . 
utilities, . 2. 2 2 eee 
utime: set file access . . 
utmp and wtmp entry . 
utmp file entry. .... 
utmp file of the current / 
utmp, wtmp: utmp and 
utmpname: access utmp/ 
uucheck: check the UUCP 
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umask(2) 
umask(1) 
mount(1M) 
umount(2) 
uname(2) 
uname(1) 
ul(1) 
unget(1) 
expand(1) 
unget(1) 
ungete(3S) 
drand48(3C) 
uniq(1) 
mktemp(3C) 
units(1) 
link(1M) 
unlink(2) 
link(1M) 
umount(2) 
pack(1) 
touch(1) 
make(1) 
Isearch(3C) 
update(1M) 
sync(2) 


id(1) 
setuid(2) 
crontab(1) 
cuserid(3S) 
getuid(2) 
environ(5} 
telnet(1N) 
tftp(1N) 
ulimit(2) 
logname(3X) 
getuid(2) 
su(1) 
ttyslot(3C) 
write(1) 
edit(1) 
mail(1) 
rhosts(4N) 
wall(1M) 
fuser(1M) 
qinstall(1) 
ustat(2) 
gutil(1G) 
utime(2) 
utmp(4) 
getut(3C) 
ttyslot(3C) 
utmp(4) 
getut(3C) 
uucheck(1M) 


program for the UUCP/ 
directory clean-up. 
/configuration file for 
CTIX system copy. 
uucheck: check the 
uusub: monitor 

uucpd: network 
clean-up. uucleanup: 
job control. uustat: 
uuname: list 

/program for the 

the scheduler for the 
server. 

type, modes, speed, and/ 
information. 

names. 
CTIX-to-CTIX/ uuto, 
for the UUCP system. 
inquiry and job/ 
network. 
CTIX-to-CTIX system/ 
remote system with/ 
command execution. 
command requests. 


val: 

u3b5, vax: provide truth 
return integer absolute 
name. getenv: return 
/remainder, absolute 
putenv: change or add 
/ntohl, ntohs: convert 
machine-dependent/ 
false: provide truth 
machine dependent 
/formatted output of a 
argument list. 

varargs: handle 

driver for tunable 

edit: text editor 

mc68k, pdp1l, u3b, u3b5, 


letter from argument 
assertion. assert: 
qinstall: install and 

tabs to spaces, and vice 
ve: 

get: get a 

scesdiff: compare two 
print/ vprintf, 

Volume Home Blocks 
(visual) display editor/ 
tabs to spaces, and 
/mvt: typeset documents, 
/package for typesetting 
/a terminal to use as the 
vt: 
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uucico: copy-in/copy-out . 
uucleanup: uucp spool . . 
uucp communications/ . . 
uucp: CTIX system to .. 
UUCP directories and/ . . 
uucp network. 
uuep server. 
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uucp spool directory .... 


uucp status inquiry and. 
UUCP system names. .. 
UUCP system. ....-. 
UUCP system. uusched: . 
uucpd: network uucp  . . 
uugetty: set terminal .. 
uulog: output logfile . .. 
uuname: list UUCP system 
uupick: public 
uusched: the scheduler .. 
uustat: uucp status ... 
uusub: monitor uucp ... 
uuto, uupick: public . .. 
Uutry: try to contacta .. 
uux: CTIX to CTIX remote 
uuxqt: execute remote .. 
val: validate SCCS file. . 
validate SCCS file. ... 
value about your/ /u3b, . 
value. abs: 2. 2 ee es 
value for environment .. 
value functions. ..... 
value to environment. .. 
values between host and/ 

Wales ie ooo setle oS. leew? 
values. true, 
values. values: . - 2... 
varargs argument list. .. 
varargs: handle variable . 
variable argument list. . . 
variables. /a loadable . . 
(variant of ex for/ .... 
vax: provide truth value/ . 
ve: version control. ... 
vector. /getoption ... 
verify program 
verify software using/ .. 
versa, /unexpand: expand 
version control. . 2. . «+. 
version of an SCCS file. . 
versions of an SCCS/  . . 
vfprintf, vsprintf: 
(VHB). /manipulate .. . 
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vi: screen-oriented ..... 


vice versa. fexpand ... 
view graphs, and slides. . 
view graphs and slides. . . 
virtual system console. . . 
virtual terminal. 
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uucico(1M) 
uucleanup(1M) 
Devices(5) 
uucp(1C) 
uucheck(1M) 
uusub(1M) 
uucpd(INM) 
uucleanup(1M) 
uustat(1C) 
uuname(1C) 
uucico(1M) 
uusched(1M) 
uucpd(1NM) 
uugetty(1M) 
uulog(1C) 
uuname(1C) 
uuto(1C) 
uusched(1M) 
uustat(1C) 
uusub(1M) 
uuto(1C) 
Uutry(1M) 
uux(1C) 
uuxqt(1M) 
val(1) 

val(1) 
machid(1) 
abs(3C) 
getenv(3C) 
floor(3M) 
putenv(3C) 
byteorder(3N) 
values(5) 
true(1) 
values(5} 
vprintf(3S) 
varargs(5) 
varargs(5) 
mktunedrv(1M) 
edit(1) 
machid(1)} 
ve(1) 
getopt(3C) 
assert(3X) 
qinstall(1) 
expand(1) 
ve(1) 

get(1) 
seesdiff(1) 
vprintf(3S) 
libdev(3X) 
vi(1) 
expand(1) 
mmt(1) 
my(5) 
conlocate(1M) 
vt(7) 


Vi: screen-oriented 
vme: 


file systems with label/ 
libdev: manipulate 
initialize and maintain 
vsprintf: print/ 
vprintf, vfprintf, 


of process. 

to stop or/ wait: 
process to stop or/ 
ftw: 

users. 


files. 

of a/ signal: specify 
whodo: 

local network. rwho: 
who: 

system. 

what. 

/long lines for finite 
primitives. window: 
wm: 

management primitives. 


cd: change 

chdir: change 

/get path-name of current 
pwd: 

on disk. setenet: 

swrite: synchronous 

write: 

entry. putpwent: 

wall: 

write: 


user. 

open for reading or 
utmp, wtmp: utmp and 
entry formats. utmp, 
connect/ fwtmp, 
hunt-the- wumpus. 
argument list(s) and/ 
parameters for Xylogics/ 
strings in C programs. 
/set drive parameters for 
functions. j0, jl, jn, 

JO, j1, jn, yO, 
compiler-compiler. 

JO, j1, jn, yO, yl, 

TZ: time 
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(visual) display editor/ . 
VME bus interface. .. 
vme: VME bus interface. 
volcopy, labelit: copy. 
Volume Home Blocks/ . 
volume. iv: . 2. ee 
vprintf, vfprintf, ... 
vsprintf: print/ .... 
vt: virtual terminal. . . 
wait: await completion . 
wait for child process . 
wait: wait for child .. 
walk afile tree. . 2... 
wall: write toall ... 
we: word count. . 2. 6 
what: identify SCCS .. 
what to do upon receipt 

who is doing what. .. 
who is logged inon .. 
who is on the system. . 
who: whois onthe .. 
whodo: who is doing . . 
width output device. . . 
window management . 
window management. . 
window: window .. . 


wm: window management. 


working directory. . . . 
working directory. . . . 
working directory. .« .. 
working directory name. 
write Ethernet address . 
write on a file. 
write onafile. . 2... 
write password file . . 
write to all users. . 2. 
write to another user. . 
write: write on afile. . 
write: write to another . 
writing. open: .... 
wtmp entry formats. . . 
wtmp: utmp and wtmp 

wtmpfix: manipulate . . 
wump:the gameof .. 
xargs: construct 2... « 
xmset: set drive ... . 
xstr: extract and share . 
Xylogics 772 half-inch/ . 
yO, yi, yn: Bessel . 2. 
yl, yn: Bessel/ 2... 
yacc: yet another ... 
yn: Bessel functions. . . 
zone file. 
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vi(1) 
yme(7) 
vme(7} 
volcopy(1M) 
libdev(3X) 
iv(1) 
vprintf(3S) 
vprintf(3S) 
vt(7) 
wait(1) 
wait(2) 
wait(2) 
ftw(3C) 
wall(1M) 
we(1) 
what(1) 
signal(2) 
whodo(1M) 
rwho(1N) 
who(1) 
who(1) 
whodo(1M) 
fold(1) 
window(7) 
wm(1) 
window(7) 
wm(1) 
ed(1) 
chdir(2) 
getcwd(3C) 
pwd(1) 
setenet(1NM) 
swrite(2) 
write(2) 
putpwent(3C) 
wall(1M) 
write(1) 
write(2) 
write(1) 
open(2) 
utmp(4) 
utmp(4) 
fwtmp(1M) 
wump(6) 
xargs(1) 
xmset(1M) 
xstr(1) 
xmset(1M) 
bessel(3M) 
bessel(3M) 
yace(1) 
bessel(3M) 
tz(4) 
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acct . 2. «+... -. . enable or disable process accounting 
alarm 2. 1. ww ee ew ee Seta process alarm clock 
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brk. 2... .... .. . change data segment space allocation 
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chroot .. 2. 1. ee we ee ew ws « Change root directory 
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connect ........ =... « imitiate a connection on a socket 
creat. ...... . . create a new file or rewrite an existing one 
dup............ . . duplicate an open file descriptor 
CXEC ww ee ee ee ee ee eee we ww ef eXUCUtE 2 file 
exit. 2 ee eee ee ee ee ee ew ee | terminate process 
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kill. . . . . . . send a signal to a process or a group of processes 
Iddrv 2. ww ww ww ew ew ww ee es « access loadable drivers 
Vink” s-se! 56> wo Sedoe eh rim> ever te ses » - .. . link toa file 
NiStenics cep 65 decd jel neuen ey Me te Tisten for connections on a socket 
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mount . 2... ee ee ee ee ew we © mount a file system 
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OPeNl? fers ist ib: eee ai eee ei a open atile specified by i-node 
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read. wee ee ee ee ee ee we ee ee se read from file 
TECV «2 se ee ww ee we es receive a message from a socket 
semctl .......4. 4.4... . «Semaphore control operations 
semget eee ee ee ew we we we ef . get set of semaphores 
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send... ...+........ «Send a message to a socket 
setpgrp «2... 6. se ee ee es - Set process group ID 
setuid .. 6... ee ee ee ee « «Set User and group IDs 
shmectl....... .. . . «shared memory control operations 
shmget ............. «get shared memory segment 
shmop ....... a Fel siel or ee shared memory operations 
shutdown. ..... shut down part of a full-duplex connection 
signal ..... . . «specify what to do upon receipt of a signal 
socket ........ . . create an endpoint for communication 
Stat 2. 6 6 ew eee we ee ee ee eee ws get file status 
SUME wie ee a ee Sw We eee ee wb oe ee set time 
swrite . 1... +. +... « «synchronous write on a file 
SYNC «ee we ew we ew ww ww ew we ee Update super-block 
syslocal . 2... 1. 2 we ee es « « Special system requests 
CUM Geo. a ah tee es a ee hed GA eel “deta ce see's BE’ LUNE 
times . ...... 4... ~ « get process and child process times 
ulimit . 2.6... 2. 1 ee ee ee get and set user limits 
umask. ............ .set and get file creation mask 
umount 2... 6... + ee ee ee © unmount a file system 
uname ........... . get name of current CTIX system 
unlink... . 6 1 ee ee we we ee. Pemove directory entry 
ustat . 6 2 ee ee we ww ew ew ws . get file system statistics 
utime ......... . «set file access and modification times 
wait .... .. . . . wait for child process to stop or terminate 
WHIGG: <1) ,.re, ceo Wet ok Hep ey oa alge bo Soe - + « . . write on a file 
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intro... + » . . Introduction to subroutines and libraries 
a64l.... convert between long integer and base-64 ASCII string 
abort. . 2... 2 ee ee we ew ee  / generate an IOT fault 
abs 2... ee ee ew es ee | return integer absolute value 


assert ...... «+ + » « . . . Verify program assertion 
AbOR oe eee, Sato se convert ASCII string to floating-point number 
Bessel) so seca sat tna ee ab es Sw at Ze - . » . « Bessel functions 
bsearch . .. ‘ + « « . . . binary search a sorted table 


byteorder . . convert palues between host and network byte order 
clock. 1... ee ee ee ew we we ee Feport CPU time used 
CONV «2 6 ee ew ew ew we ew ww ew we eh we translate characters 
crypt . 2 + 2 ee «© © ww we © we generate hashing encryption 
ctermid. .......... . . generate file name for terminal 
ctime ........... . .convert date and time to string 
ctype ..... oe eo © we © we e © Classify characters 
curses ..... . CRT screen handling and 6ptinization package 
cuserid. ..... - » . . get character login name of the user 
ial “od cesta oda establish an out-going terminal line connection 
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drand48 . . generate uniformly distributed pseudo-random numbers 
ecvt ........ . . convert floating-point number to string 
ONG eee ayes Gee ca! obs Ses aes ee eee last locations in program 
erf.... .. . error function and complementary error function 
exp... . . exponential, logarithm, power, square root functions 
fclose 2... 2. ee ee ee ee | Close or flush a stream 


ferror .... oe ee we ew ©] 6. Stream status inquiries 
floor . .... DilboE ceiling, remainder, absolute value functions 
fOpen 6: So sseceek Ue Nee 6 eC ee er ee - open a stream 
ATCO. 163-1 Te Seale es Mite Sree oa wee eee binary input/output 
frexp ... .. . . . manipulate parts of floating-point numbers 
fSCOK ma: oie cae ee a es BE Teposition a file pointer in a stream 
POWerds ee ae: Bee SS ee es eee a - ... . walk a file tree 
gamma.......eeee +. « .. - . log gamma function 


getc . ........ =. . . get character or word from a stream 
getcwd ..... . «get path-name of current working directory 


BevenV: eke Me ce sees ee ele we return value for environment name 
getgrent . 2... 2 eee eae » . - « « . get group file entry 
gethostent .......2.42e6. . . . get network host entry 
gethostname ..... 2.2. eee eee get name of current host 
GOtlOBIN o.10'. di ercig, oe ke Ee acs oe e © es . get login name 
getnetent. .. 2... ee ee ee . » . get network entry 
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getprotoent. . . 2... ee + eee ee © ~~ get protocol entry 
BetpW: ee ee ten tee 'e . . . « » get name from UID 
getpwent. .......+..s..+.... © get password file entry 
gets 2... 2. eee eee es. - get astring from a stream 
getservent . 2. 2. ee ew ew we ww eo Bet SeTVice entry 
getut . 2 2 6 ww ww ew ww ww ww ew ee ACCESS UtMp file entry 


hsearche <6 “see se ted tesa hr ee . » »« Manage hash search tables 
DY POt? sex cei te, tee Ae ik ep ee a, ets Euclidean distance function 
INGt, oioe Ges 2. lo ne er ale Internet address manipulation routines 


I3tol . . . . . . convert between 3-byte integers and long integers 
Idahread . . read the archive header of a member of an archive file 
Idclose: 2-6 ek ee ee . . close a common object file 
Idfhread . . . . . . ~ read the file header of a common object file 
Idgetname ... . . retrieve symbol name for common object file 
Idlréad: %: ee: io: doe tee: eat ee ew manipulate line number entries 
Idiseek ... » » « » Seek to line number entries of a section 
Idohseek . . seek 6 the optional file header of a common object file 
Idopen ...... .. . . open acommon object file for reading 
Idrseek . ....... . . seek to relocation entries of a section 
ldshread . . . .. . . . . read an indexed/named section header 
Idsseek . seek to an indexed/named section of a common object file 
Idtbindex . . . . . . . compute the index of a symbol table entry 
Idtbread . 2... - . ». .Yead an indexed symbol table entry 
Idtbseek. . .. nehek to the symbol table of a common object file 
libdev ...... . . «manipulate Volume Home Blocks (VHB) 
lOCKL aco Sg Fg sR, a AE oP ees . record locking on files 
logname. .. 2 8 ta we ed eA . » «return jogin name of user 
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eee ee ew we we ew linear search and update 


malloc... 2... ee eee ee es main memory allocator 
malloc... ........... . fast main memory allocator 
matherr.............. . . errorhandling function 
memory . . 6 ee ee ww ew ee ew we es / MEMOTY Operations 
mktemp ............. . .makea unique file name 
monitor +o 4 8 ew ee ww ee © ] prepare execution profile 
nlist ee ee ew ow ew we ee get entries from name list 
ocurse oe ee ee ew | . Optimized screen functions 
perror oe ee ee ee ew . System error messages 
plot. ......4.4.+.4.4... . graphics interface subroutines 
popen.. s+ eee ss. | . initiate pipe to/from a process 
printf ee ee ee ew ww ww ew dprint formatted output 
pute + + » « . put character or word on a stream 
putenv........ .. . change or add value to environment 
putpwent ........... .. © write password file entry 
puts . oe ee ew ew ee puta string on a stream 
qsort PP PIES ONE Ty ea See de eo Oe 
rand + + «© « « « . simple random-number generator 
remd .. routines for returning a stream to a remote command 
regemp + + 6 « « « « - compile and execute regular expression 
rexec + + + « « « «return stream to a remote command 
scanf. 2 6 6 ew ee ew ee ew ee Convert formatted input 
setbuf. ............ . . assign buffering to a stream 
setimp 2... ee ee ee ee ee ee ee ee nON-lOCAl Goto 


sinh 2... ee ee ee ee ew we we © » hyperbolic functions 


sleep . 
sput] . 


eee ew ew ew ee  SUSpend execution for interval 
- access long integer data in a machine-independent fashion. 


ssignal . 2. 1 ee ee ee ee ee ee we »  SOftware Signals 
stdio . eee 2 . standard buffered input/output package 
stdipce . . . . . . . standard interprocess communication package 
string. . ee eee ee we ee eh whe] 6 String Operations 


strtod . - convert string to double-precision number 
strtol . «+ ee » ~~ . convert string to integer 
swab. ee ee ew ew ew ee ee Swap bytes 
system . * + 6 « «© © © « « issue a Shell command 


termcap .. 


- . . . terminal independent operations 


tmpfile + + ee « © « . create a temporary file 
tmpnam . + . . . create a name for a temporary file 
trig. . oe ee « « © trigonometric functions 
tsearch + « +» + » «manage binary search trees 
ttyname + + + « » « . . find name of a terminal 
ttyslot . . find the slot in the utmp file of the current user 
ungetc . . - . push character back into input stream 
vprintf . : print formatted output of a varargs argument list 


4. File Formats 


intro 
a.out 
acct 
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«2 e+ » © © . introduction to file formats 
- common assembler and link editor output 
- + » » per-process accounting file format 


OF sans, AST E oc ee eas Ges . common archive file format 


checklist . 2... ee eee list of file systems processed by fsck 
(0) ae eet eae ae a ee Se format of core image file 
CDIO! s,s Bh ey saria) 6 5. Ske, eh Ge eat el format of cpio archive 


cprofile . . . . . . setting up a C shell environment at login time 
dir 2 ew ee ee ee ew ew we we © © format of directories 


OITA eras: se) ge ee se dso sei ale cee error-log file format 
filehdr. ........ .. . file header for common object files 
ISR: ect ot ash: Be ees es ae cute a ie . - «file system format 


fspec ........ +... « format specification in text files 
gettydeis . .... . . speed and terminal settings used by getty 
gps... . . . graphical primitive string, format of graphical files 
SFOUP 2 ee ee ee ee ee ee ee we we ee we ws  BrOUp fill 


OSts 6 ae is el a ee WE ee . . . list of nodes on network 
MMIGtAD 6 wed cen Se Soe cdicerek oh Se 4 script for the init process 
INOdG! oi: a seine a teed Reh ee A ce format of an i-node 
ISSUC*S: oe Se a Se ee + + « « « issue identification file 
Wich: 48 35: aot 7S kOe ak Be common Sbject file access routines 
linenum ... . . . . line number entries in a common object file 
TM ASCER o.oo ewe Se eRe Se master device information table 
Inhttab je ee bk ee we as mounted file system table 
networks .......... names and numbers for the internet 
PASSW ed SS, oN alter poh eke GS Get Sey eee eee password file 
DIOL? say orretety eeveiretet man stay Weis - . + . graphics interface 
profile ........ . setting ie an environment at login time 
protocols: 4.4. 4-3. anal eee 2 Se list of Internet protocols 
reloc. . . . . . . relocation information for a common object file 
THOStS fo 76.5: gh he es ee en - » » remote equivalent users 
SCOSTIE: Veo a tice a eee Seles Ses . . « . format of SCCS file 
senhdr ....... . . section header for a common object file 
SCIVICES! aw ee ie OPS RS SS . « . . list of Internet services 
syms . ..... +. + «common object file symbol table format 
SYSCEMN: coe ees osda? ter ee cate wre SOS) Bn ces system description file 
Germ. ses we Sh ae ee Ss format of compiled term file. 
Cermcapy s6 cece eo es, Se) Se termina! capability data base 
termini: Asma Seed Be a er’ terminal capability data base 
ttytype .... . . . . list of terminal types by terminal number 
ES BoB allel Sates a ee oe, ea a awe ey wh . time zone file 
WOM Poe nee ee ee ee, es oo SS utmp and wtmp entry formats 


5. Miscellaneous Facilities 


intro... 1... ee... . | . introduction to miscellany 
ASC] se ee ew we ew we ee ~ map Of ASCII character set 
Devices . . . . . configuration file for uucp communications lines 


Dialers: an 6, te eae Se ees 8 es ACU/modem calling protocols 
environ . Bhai Vee be oe, Gas eet ts . « . user environment 
eqnchar ... .. . special character definitions for eqn and neqn 
femntl!  c..0 6 baw lee were Sod on ae . . - - file control options 
man .... . . . . macros for formatting entries in this manual 
THAD 6 se Sigs ee ee a ees - math functions and constants 
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mm... . . .the MM macro package for formatting documents 
mptx . . . . the macro package for formatting a permuted index 
mv . .atroff macro package for typesetting view graphs and slides 
Proll -s. sceo whe ee - «+... . profile within a function 
regexp sw wee sremuilar expression compile and match routines 
stat 2... 2... ... .. . . . data returned by stat system call 
term . 6 + 2 2 « 6 «© « «. « « «conventional names for terminals 
types . . 2. 6 © ee ee ss © © | primitive system data types 
values .. 6... ee ees « ~ « Machine-dependent values 
varargs ........ =... . ~ handle variable argument list 


6. Games 


Intro. 2 ew we ee ee ee we ee ee introduction to gaines 
advent .. 2... 2. 2 ee ee eee  « explore Colossal Cave 
arithmetic .......-4.2e6. provide drill] in number facts 
back ............... . the game of backgammon 
bh... we ee ee we ee ee ee the game of black jack 
Craps. ew ew ew ew we ww ww ew ww eS dc the game of craps 
TISH* ies, wiser ners. te 8M Br eae ee we wee DAY “GO Eish” 
fortune ...... print a radon hopefully interesting, adage 
Monee sae e ato ee heel 2 guess the word 
IMAZE 50s io ot estes Se Uey. Wie Sh te ea a ae Ss - Benerate a maze 
TOO! iad se) Sede pa 08) Mo by ee sa Oe ee a - . « guessing gume 
NUMIDEL 6-6 Ge ae ye EE GE poner Arabic numerals to English 
QUIZ 2 ww eee we ee ee ee ee we wf test your Knowledge 
Pr eta neg Beles le Hoke bce eves al cena le eae 
LOG of as bdo HSE ce Ste ES ele cae Pe eee Eh a se te-tac-toe 
wump.......+..... . . the game of hunt-the-wumpus 


7. Special Files 


intro. . 2... 6. ee ee © | © introduction to special files 
console . 1. 6 ee ew ee ee ww we we © Console terminal 
disk... 1 6 6 ee ee ee eee ee ee general disk driver 
drivers. . 2 1 1 ee ee ee © ee © « loadable device drivers 
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termlio .....-+.+. +... ~ general terminal interface 
IGP? valet ai eae) a cee Be Se Raves . terminal accelerator interface 
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NAME 

intro — introduction to system calls and error numbers 
SYNOPSIS 

#include <errno.h> 
DESCRIPTION 


This section describes all of the system calls. 


System call entries that are suffixed by (2N) are part of 
the CTIX networking packages. The link editor searches 
these calls under the —1 socket option. To use these 
calls you must have the network protocols on your 
system. See the CTIX Internetworking Manual for 
further information. 


Most of these calls have one or more error returns. An 
error condition is indicated by an otherwise impossible 
returned value. This is almost always —1; the individual 
descriptions specify the details. An error number is also 
made available in the external variable errno. Errno is 
not cleared on successful calls, so it should be tested only 
after an error has been indicated. 


Each system call description attempts to list all possible 
error numbers. The following is a complete list of the 
error numbers and their names as_ defined in 
<errno.h>. 


1 EPERM Not super-user 
Typically this error indicates an attempt to 
modify a file in some way forbidden except to its 
owner or super-user. It is also returned for 
attempts by ordinary users to do things allowed 
only to the super-user. 


2 ENOENT No such file or directory 
This error occurs when a file name or IPC 
identifier is specified and the file or IPC 
structure should exist but doesn’t, or when one 
of the directories in a path name does not exist. 


3 ESRCH No such process 
No process can be found corresponding to that 
specified by pid in kill or ptrace. 


4 EINTR Interrupted system call 
An asynchronous signal (such as interrupt or 
quit), which the user has elected to catch, 
occurred during a system call. If execution is 
resumed after processing the signal, it will 
appear as if the interrupted system call returned 
this error condition. 
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5 EIO I/O error 
ome physical I/O error has occurred. This 
error may in some cases occur on a call following 
the one to which it actually applies. 


6 ENXIO No such device or address 

1/O on a special file refers to a subdevice which 
does not exist, or beyond the limits of the 
device. It may also occur when, for example, a 
tape drive is not on-line or no disk pack is 
loaded on a drive. On local terminals, it may 
indicate that the host terminal lacks the 
specified channel; for example, opening tpa256, 
when tty256 refers to a Programmable Terminal, 
not a Graphics Terminal. 


7 E2BIG Arg list too long 
An argument list longer than 10,240 bytes is 
presented to a member of the ezec family. 


8 ENOEXEC Exec format error 
A request is made to execute a file which, 
although it has the appropriate permissions, does 
not start with a valid magic number (see 
a.out(4)), or the executable file requires 
hardware that does not exist (e.g., floating- 
point). 

9 EBADF Bad file number 
Either a file descriptor refers to no open file, or a 
read (respectively, write) request is made to a 
file which is open only for writing (respectively, 
reading). 


10 ECHILD No child processes 
A watt was executed by a process that had no 
existing or unwaited-for child processes. 


11 EAGAIN No more processes 
A fork failed because the system’s process table 
is full or the user is not allowed to create any 
more processes, or an IPC call is made with the 
IPC_NOWAIT option and the caller would 
block. 


12 ENOMEM Not enough space 
During an ezec, brk, or sbrk, a program asks for 
more space than the system is able to supply. 


13 EACCES Permission denied 
An attempt was made to access a file or IPC 
structure in a way forbidden by the protection 
system. From locking, an attempt to lock bytes 
already under a checking lock. 
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EFAULT Bad address 
The system encountered a hardware fault in 
attempting to use an argument of a system call. 


ENOTBLK Block device required 
A non-block file was mentioned where a block 
device was required, e.g., in mount. 


EBUSY Device or resource busy 

An attempt was made to mount a device that 
was already mounted or an attempt was made to 
dismount a device on which there is an active 
file (open file, current directory, mounted-on file, 
active text segment). It will also occur if an 
attempt is made to enable accounting when it is 
already enabled. The device or resource is 
currently unavailable. 


EEXIST File exists 
An existing file or IPC structure was mentioned 
in an inappropriate context, e.g., link. 


EXDEV Cross-device link 
A link to a file on another device was attempted. 


ENODEV No such device 
An attempt was made to apply an inappropriate 
system call to a device; e.g., read a write-only 
device. 


ENOTDIR Not a directory 
A non-directory was specified where a directory 
is required, for example in a path prefix or as an 
argument to chdir(2). 


EISDIR Is a directory 
An attempt was made to write on a directory. 


EINVAL Invalid argument 
Some invalid argument (e.g., dismounting a 
non-mounted device; mentioning an undefined 
signal in stgnal, or kill; reading or writing a file 
for which Iseek has generated a _ negative 
pointer). Also set by the math functions 
described in the (3M) entries of this manual. 


ENFILE File table overflow 


The system file table is full, and temporarily no 
more opens can be accepted. 


EMFILE Too many open files 
No process may have more than 20 file 
descriptors open at a time. When a record lock 
is being created with fentl, there are too many 
files with record locks on them. 
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ENOTTY Not a character device 
An attempt was made to toctK2) a file that is 
not a special character device. 


ETXTBSY Text file busy 
An attempt was made to execute a pure- 
procedure program that is currently open for 
writing. Also an attempt to open for writing a 
pure-procedure program that is being executed. 


EFBIG File too large 
The size of a file exceeded the maximum file size 
(1,082,201,088 bytes) or ULIMIT; see ulimit(2). 


ENOSPC No space left on device 
During a wrtte to an ordinary file, there is no 
free space left on the device. In fentl, the setting 
or removing of record locks on a file cannot be 
accomplished because there are no more record 
entries left on the system. In an IPC call, no 
IPC identifiers are available. 


ESPIPE Illegal seek 
An lseek was issued to a pipe. 


EROFS Read-only file system 
An attempt to modify a file or directory was 
made on a device mounted read-only. 


EMLINK Too many links 
An attempt to make more than the maximum 
number of links (1000) to a file. 


EPIPE Broken pipe 
A write on a pipe for which there is no process 
to read the data. This condition normally 
generates a signal; the error is returned if the 
signal is ignored. 


EDOM Math argument 
The argument of a function in the math package 
(3M) is out of the domain of the function. 


ERANGE Result too large 
The value of a function in the math package 
(3M) is not representable within machine 
precision. 

ENOMSG No message of desired type 
An attempt was made to receive a message of a 
type that does not exist on the specified message 
queue; see msgop(2). 

EIDRM Identifier Removed 
This error is returned to processes that resume 
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execution due to the removal of an identifier 
from the file system’s name space (see magcil(2), 
semetl(2), and shmceti(2)). 

ECHRNG Channel number out of range 
Not used; retained for compatebility. 

EL2NSYNC Level 2 not synchronized 
Not used; retained for compatibility. 


EL3HALT Level 3 halted 
Not used; retatned for compatibility. 


EL3RST Level 3 reset 
Not used; retained for compatibility. 


ELNRNG Link number out of range 
Not used; retained for compattbiltty. 


EVNATCH Protocol driver not attached 
Not used; retatned for compatibility. 


ENOCSI No CSI structure available 
Not used; retained for compatibility. 


EL2HLT Level 2 halted 
Not used; retained for compatibility. 


EDEADLK Record locking deadlock 
Call cannot be honored because of a potential 
deadlock. See fentl(2). 


ENOLCK No record locks available 
No free entries are currently available in the 
kernel lock array. 


EBADE Invalid exchange 
A user-specified exchange descriptor is out of 
range or specifies an unallocated exchange. 


EBADR Invalid request descriptor 
An attempt has been made to reference a request 
that is not outstanding. 


EXFULL Exchange full 
No request descriptors are currently available for 
this exchange. 


ENOANO No anode 
Not used; retained for compatibility. 


EBADRQC Invalid request code 
No routing is currently available for this request 
code. 


EBADSLT Invalid slot 
Not used; retained for compatibility. 
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56 EDEADLOCK Deadlock error 
Call cannot be honored because of potential 
deadlock or because lock table is full. See 
locking (2). 

57 EBFONT Bad font file format 
Not used; retatned for compatibility. 


224 ENOHDW No hardware available for operation 
The address specification exceeds the allowable 
limits or the required hardware does not exist. 
See ezec(2). 


225 EBADFS Bit-mapped file system is marked dirty 
An attempt to mount a bit-mapped file system 
failed due to the dirty flag being set for that file 
system. 


226 EWOULDBLOCK Operation would block 
An operation which would cause a process to 
block was attempted on a object in non-blocking 
mode. 


227 EINPROGRESS Operation now in progress 
An operation which takes a long time to 
complete (such as a connect(2N)) was attempted 
on a non-blocking object. 

228 EALREADY Operation already in progress 
An operation was attempted on a non-blocking 
object which already had an operation in 
progress. 

229 ENOTSOCK Socket operation on non-socket 
Self-explanatory. 

230 EDESTADDRREQ Destination address required 
A required address was omitted from an 
operation on a socket. 


231 EMSGSIZE Message too long 
A message sent on a socket was larger than the 
internal message buffer. 

232 EPROTOTYPE Protocol wrong type for socket 
A protocol was specified which does not support 
the semantics of the socket type requested. For 
example, you cannot use the ARPA Internet 
UDP protocol with type SOCK_STREAM. 

233 EPROTONOSUPPORT Protocol not supported 
The protocol has not been configured into the 
system or no implementation for it exists. 

234 ESOCKTNOSUPPORT Socket type not supported 
The support for the socket type has not been 
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configured into the system or no implementation 
for it exists. 


EOPNOTSUPP Operation not supported on socket 
For example, trying to accept a connection on a 
datagram socket. 


EPFNOSUPPORT Protocol family not supported 
The protocol family has not been configured into 
the system or no implementation for it exists. 


EAFNOSUPPORT Address family not supported by 
protocol 
An address incompatible with the requested 
protocol was used. For example, you shouldn’t 
necessarily expect to be able to use PUP Internet 
addresses with ARPA Internet protocols. 


EADDRINUSE Address already in use 
Only one usage of each address is normally 
permitted. 


EADDRNOTAVAIL Can’t assign requested address 
Normally results from an attempt to create a 
socket with an address not on this machine. 


ENETDOWN Network is down 
A socket operation encountered a dead network. 


ENETUNREACH Network is unreachable 
A socket operation was attempted to an 
unreachable network. 


ENETRESET Network dropped connection on reset 


The host you were connected to crashed and 
rebooted. 


ECONNABORTED- Software caused connection 
abort 
A connection abort was caused internal to your 
host machine. 


ECONNRESET Connection reset by peer 
A connection was forcibly closed by a peer. This 
normally results from the peer executing a 
shutdown (2) call. 

ENOBUFS No buffer space available 
An operation on a socket or pipe was not 


performed because the system lacked sufficient 
buffer space. 


EISCONN Socket is already connected 
A connect request was made on an already 
connected socket; or, a sendto or sendmsg 
request on a connected socket specified a 
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destination other than the connected party. 


247 ENOTCONN Socket is not connected 
An request to send or receive data was 
disallowed because the socket is not connected. 


248 ESHUTDOWN Can’t send after socket shutdown 
A request to send data was disallowed because 
the socket had already been shut down with a 
previous shutdown(2) call. 


249 ETOOMANYREFS Too many references: cant’ splice 


250 ETIMEDOUT Connection timed out 
A connect request failed because the connected 
party did not properly respond after a period of 
time. (The timeout period is dependent on the 
communication protocol.) 


251 ECONNREFUSED Connection refused 
No connection could be made because the target 
machine actively refused it. This usually results 
from trying to connect to a service which is 
inactive on the foreign host. 


252 EHOSTDOWN Host is down 
The host is down. 


253 EHOSTUNREACH No route to host 
The gateway does not recognize the requested 
host via the route specified. 


254 ENOPROTOOPT Protocol not available 
A bad option was specified in a getsockopt(2N) 
or setsockopt(2N) call. 
DEFINITIONS 
Process ID 
Each active process in the system is uniquely identified 


by a positive integer called a process ID. The range of 
this ID is from 1 to 30,000. 


Parent Process ID 
A new process is created by a currently active process; 
see fork(2). The parent process ID of a process is the 
process ID of its creator. 


Process Group ID 
Each active process is a member of a process group that 
is identified by a positive integer called the process 
group ID. This ID is the process ID of the group leader. 


This grouping permits the signaling of related processes; 
see kill(2). 
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Group ID 

Each active process can be a member of a terminal group 
that is identified by a positive integer called the tty 
group ID. This grouping is used to terminate a group of 
related processes upon termination of one of the 
processes in the group; see eztt(2) and signal(2). 


Real User ID and Real Group ID 


Each user allowed on the system is identified by a 
positive integer called a real user ID. 


Each user is also a member of a group. The group is 
identified by a positive integer called the real group ID. 


An active process has a real user ID and real group ID 
that are set to the real user ID and real group ID, 
respectively, of the user responsible for the creation of 
the process. 


Effective User ID and Effective Group ID 


An active process has an effective user ID and an 
effective group ID that are used to determine file access 
permissions (see below). The effective user ID and 
effective group ID are equal to the process’s real user ID 
and real group ID respectively, unless the process or one 
of its ancestors evolved from a process that had the set- 
user-ID bit or set-group ID bit set; see exec(2). 


Super-user 


A process is recognized as a super-user process and is 
granted special privileges if its effective user ID is 0. 


Special Processes 


File 


File 
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The processes with a process ID of 0 and a process ID of 
1 are special processes and are referred to as procO and 
procl. 


ProcO is the scheduler. Proct is the initialization 
process (tit). Procl is the ancestor of every other 
process in the system and is used to control the process 
structure. 


Descriptor 

A file descriptor is a small integer used to do I/O on a 
file. The value of a file descriptor is from 0 to 19. A 
process may have no more than 20 file descriptors (0-19) 
open simultaneously. A file descriptor is returned by 
system calls such as open(2), or ptpe(2). The file 
descriptor is used as an argument by calls such as 
read(2), write(2), ¢oct(2), and close(2). 

Name 

Names consisting of 1 to 14 characters may be used to 
name an ordinary file, special file or directory. 
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These characters may be selected from the set of all 
character values excluding \O (null) and the ASCII code 
for / (slash). 


Note that it is generally unwise to use *, ?, [, or ] as part 
of file names because of the special meaning attached to 
these characters by the shell. See sh(1). Although 
permitted, it is advisable to avoid the use of unprintable 
characters in file names. 


Path Name and Path Prefix 
A path name is a null-terminated character string 
starting with an optional slash (/); followed by zero or 
more directory names separated by slashes, optionally 
followed by a file name. 


More precisely, a path name is a _null-terminated 
character string constructed as follows: 


<path-name >::== <file-name >| <path-prefix > <file- 
name >|/ 

<path-prefix > ::=<rtprefix>| /<rtprefix> 

<rtprefix > ::= < dirname >/| <rtprefix > <dirname > / 


where <file-name> is a string of 1 to 14 characters 
other than the ASCII slash and null, and <dirname> is 
a string of 1 to 14 characters (other than the ASCII slash 
and null) that names a directory. Any number of 
consecutive slashes is equivalent to a single slash. 


If a path name begins with a slash, the path search 
begins at the root directory. Otherwise, the search 
begins from the current working directory. 


A slash by itself names the root directory. 


Unless specifically stated otherwise, the null path name 
is treated as if it named a non-existent file. 


Directory 
Directory entries are called links. By convention, a 
directory contains at least two links, . and .., referred to 
as dot and dot-dot respectively. Dot refers to the 
directory itself and dot-dot refers to its parent directory. 


Root Directory and Current Working Directory 
Each process has associated with it a concept of a root 
directory and a current working directory for the purpose 
of resolving path name searches. The root directory of a 
process need not be the root directory of the root file 
system. 


File Access Permissions 
Read, write, and execute/search permissions on a file are 
granted to a process if one or more of the following are 
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true: 
The effective user ID of the process is super-user. 


The effective user ID of the process matches the 
user ID of the owner of the file and the 
appropriate access bit of the “owner” portion 
(0700) of the file mode is set. 


The effective user ID of the process does not 
match the user ID of the owner of the file, and 
the effective group ID of the process matches the 
group of the file and the appropriate access bit 
of the “group” portion (070) of the file mode is 
set. 


The effective user ID of the process does not 
match the user ID of the owner of the file, and 
the effective group ID of the process does not 
match the group ID of the file, and the 
appropriate access bit of the ‘‘other’’ portion 
(07) of the file mode is set. 


Otherwise, the corresponding permissions are denied. 


Message Queue Identifier 
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A message queue identifier (msqid) is a unique positive 
integer created by a msgget(2) system call. Each msqid 
has a message queue and a data structure associated with 
it. The data structure is referred to as msgid_ds and 
contains the following members: 


struct ipc_perm msg_perm; 
/* operation permission struct */ 
ushort msg_qnum; /* number of msgs on q */ 
ushort msg_qbytes; /* max number of bytes on q */ 
ushort msg_lspid; /* pid of last msgsnd operation */ 
ushort msg_lIrpid; /* pid of last msgrev operation */ 
time_t msg_stime; /* last msgsnd time */ 
time_t msg_rtime; /* last msgrcv time */ 
time_t msg ctime; /* last change time */ 
/* Times measured in secs since */ 
/* 00:00:00 GMT, Jan. 1, 1970 */ 


Msg_perm is an ipc_perm structure that specifies the 
message operation permission (see below). This structure 
includes the following members: 


ushort cuid; /* creator user id */ 

ushort —cgid; /* creator group id */ 

ushort uid; /* user id */ 

ushort _ gid; /* group id */ 

ushort mode; /* r/w permission */ 
sq = 
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Msg_qnum is the number of messages currently on the 
queue. Msg_qbytes is the maximum number of bytes 
allowed on the queue. Msg_Ispid is the process id of 
the last process that performed a msgsnd operation. 
Msg_Irpid is the process id of the last process that 
performed a msgrev operation. Msg_stime is the time 
of the last msgsnd operation, msg_rtime is the time of 
the last msgrcv operation, and msg_ctime is the time of 
the last magctl(2) operation that changed a member of 
the above structure. 


Message Operation Permissions 


In the msgop(2) and magctl(2) system call descriptions, 
the permission required for an operation is given as 
"{token}”, where “token” is the type of permission 
needed interpreted as follows: 


00400 Read by user 
00200 Write by user 
00060 Read, Write by group 
00006 Read, Write by others 


Read and Write permissions on a msqid are granted to a 
process if one or more of the following are true: 


The effective user ID of the process is super-user. 


The effective user ID of the process matches 
msg_perm.|cjuid in the data _ structure 
associated with msgid and the appropriate bit of 
the “user” portion (0600) of msg_perm.mode 
is set. 


The effective user ID of the process does not 
match msg_perm.[cluid and the effective 
group ID of the process matches 
msg_perm.|c]gid and the appropriate bit of the 
“group” portion (060) of msg_perm.mode is 
set. 


The effective user ID of the process does not 
match msg_perm.[c]uid and the effective 
group ID of the process does not match 
msg_perm.|c|gid and the appropriate bit of the 
“other’’ portion (06) of msg_perm.mode is set. 


Otherwise, the corresponding permissions are denied. 


Semaphore Identifier 
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A semaphore identifier (semid) is a unique positive 
integer created by a semget(2) system call. Each semid 
has a set of semaphores and a data structure associated 
with it. The data structure is referred to as semid_ds 
and contains the following members: 
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struct ipc_perm sem_perm; 

/* operation permission struct */ 
ushort sem_nsems,; /* number of sems in set */ 
time_t sem_otime; /* last operation time */ 
time_t sem_ctime; /* last change time */ 

*Times measured in secs */ 
* since 00:00:00 GMT, */ 
/*Jan. 1, 1970 */ 


Sem_perm is an ipc_perm structure that specifies the 
semaphore operation permission (see below). This 
structure includes the following members: 


ushort cuid; /* creator user id */ 
ushort cgid; /* creator group id */ 
ushort uid; /* user id */ 

ushort gid; /* group id */ 

ushort mode; /* r/a permission */ 


The value of sem_nsems is equal to the number of 
semaphores in the set. Each semaphore in the set is 
referenced by a positive integer referred to as a 
sem_num. Sem_num values run sequentially from 0 to 
the value of sem_nsems minus 1. Sem_otime is the 
time of the last semop(2) operation, and sem_ctime is 
the time of the last semcti(2) operation that changed a 
member of the above structure. 


A semaphore is a data structure that contains the 
following members: 


ushort semval; /* semaphore value */ 

short sempid; /* pid of last operation */ 
ushort semncnt; /* # awaiting semval > cval */ 
ushort semzcnt; /* # awaiting semval = 0 */ 


Semval is a non-negative integer. Sempid is equal to 
the process ID of the last process that performed a 
semaphore operation on this semaphore. Semnent is a 
count of the number of processes that are currently 
suspended awaiting this semaphore’s semval to become 
greater than its current value. Semzcnt is a count of 
the number of processes that are currently suspended 
awaiting this semaphore’s semval to become zero. 


Semaphore Operation Permissions 
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In the semop(2) and semetl(2) system call descriptions, 
the permission required for an operation is given as 
"{token}”, where "token” is the type of permission 
needed interpreted as follows: 


00400 Read by user 
00200 Alter by user 
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00060 Read, Alter by group 
00006 Read, Alter by others 


Read and Alter permissions on a semid are granted to a 
process if one or more of the following are true: 


The effective user ID of the process is super-user. 


The effective user ID of the process matches 
sem_perm.|c uid in the data _ structure 
associated with semtd and the appropriate bit of 
the “user” portion (0600) of sem_perm.mode 
is set. 


The effective user ID of the process does not 
match sem_perm.|{e]uid and the effective group 
ID of the process matches sem_perm.|(c]gid and 
the appropriate bit of the “group” portion (060) 
of sem_perm.mode is set. 


The effective user ID of the process does not 
match sem_perm.|cluid and the effective group 
ID of the process does not match 
sem_perm.|c|gid and the appropriate bit of the 
“other’’ portion (06) of sem_perm.mode is set. 


Otherwise, the corresponding permissions are denied. 


Shared Memory Identifier 
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A shared memory identifier (shmid) is a unique positive 
integer created by a shmget(2) system call. Each shmid 
has a segment of memory (referred to as a shared 
memory segment) and a data structure associated with 
it. The data structure is referred to as shmid_ds and 
contains the following members: 


struct ipc_perm shm_perm; 
/* operation permission struct */ 
int shm_segsz; /* size of segment */ 
ushort shm_cpid; /* creator pid */ 
ushort shm_lpid; /* pid of last operation */ 
short shm_nattch; /* number of current attaches */ 
time_t shm_atime; /* last attach time */ 
time_t shm_dtime; /* last detach time */ 
time_t shm_ctime; /* last change time */ 
/* Times measured in secs since */ 
/* 00:00:00 GMT, Jan. 1, 1970 */ 


Shm_perm is an ipc_perm structure that specifies the 
shared memory operation permission (see below). This 
structure includes the following members: 


ushort —cuid; /* creator user id */ 
ushort —cgid; /* creator group id */ 
ushort uid; /* user id */ 
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ushort gid; /* group id */ 
ushort mode; /* r/w permission */ 


Shm_segsz specifies the size of the shared memory 
segment. Shm_cepid is the process id of the process that 
created the shared memory identifier. Shm_Ipid is the 
process id of the last process that performed a shmop(2) 
operation. Shm_nattch is the number of processes that 
currently have this segment attached. Shm_atime is 
the time of the last shmat operation, shm_dtime is the 
time of the last shmdt operation, and shm_ctime is the 
time of the last shmctl(2) operation that changed one of 
the members of the above structure. 


Shared Memory Operation Permissions 


In the shmop(2) and shmctl(2) system call descriptions, 
the permission required for an operation is given as 
"{token}", where "token” is the type of permission 
needed interpreted as follows: 


00400 Read by user 
00200 Write by user 
00060 Read, Write by group 
00006 Read, Write by others 


Read and Write permissions on a shmid are granted to a 
process if one or more of the following are true: 


The effective user ID of the process is super-user. 


The effective user ID of the process matches 
shm_perm.|cjuid in the data structure 
associated with shmtd and the appropriate bit of 
the “user” portion (0600) of shm_perm.mode 
is set. 


The effective user ID of the process does not 
match shm_perm.|cluid and the effective 
group ID of the process matches 
shm_perm.|c|gid and the appropriate bit of the 
“group” portion (060) of shm_perm.mode is 
set. 


The effective user ID of the process does not 
match shm_perm.|cluid and the effective 
group ID of the process does not match 
shm_perm.|c|gid and the appropriate bit of the 
“other” portion (06) of shm_perm.modée is set. 


Otherwise, the corresponding permissions are denied. 


SEE ALSO 


5/86 


intro(3 
CTIX Internetworking Manual. 


eed ioctl(2), open(2), pipe(2), read(2), write(2), 


-15- 


NAME 


ACCEPT (2N) 


accept — accept a connection on a socket 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/socket.h> 


accept(s, addr, addrlen) 
int s; 

struct sockaddr “addr; 
int *addrlen; 


DESCRIPTION 


Accept accepts a connection on a socket. The argument 
8 is a socket which has been created with socket(2), 
bound to an address with bind(2), and is listening for 
connections after a listen(2). Accept extracts the first 
connection on the queue of pending connections, creates 
a new socket with the same properties of s and allocates 
a new file descriptor for the socket. If no pending 
connections are present on the queue, and the socket is 
not marked as non-blocking, accept blocks the caller 
until a connection is present. If the socket is marked 
non-blocking and no pending connections are present on 
the queue, accept returns an error as described below. 
The accepted socket, ns, may not be used to accept 
more connections. The original socket s remains open. 


The argument addr is a result parameter which is filled 
in with the address of the connecting entity, as known to 
the communications layer. The exact format of the addr 
parameter is determined by the domain in which the 
communication is occurring. The addrlen is a value- 
result parameter; it should initially contain the amount 
of space pointed to by addr; on return it will contain the 
actual length (in bytes) of the address returned. This 
call is used with connection-based socket types, currently 


with SOCK_STREAM. 


RETURN VALUE 


The call returns —-1 on error. If it succeeds it returns a 
non-negative integer which is a descriptor for the 
accepted socket. 


ERRORS 


The accept will fail if: 
[EBADF] The descriptor is invalid. 
[ENOTSOCK] The descriptor references a file, 


not a socket. 


[EOPNOTSUPP} The referenced socket is not of 
type SOCK_STREAM. 
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[EFAULT] The addr parameter is not in a 
writable part of the user address 
space. 

SEE ALSO 


bind(2N), connect(2N), listen(2N), socket(2N). 
CTIX Internetworking Manual. 
NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NAME 


ACCESS (2) 


access — determine accessibility of a file 


SYNOPSIS 


int access (path, amode) 
char *path; 
int amode; 


DESCRIPTION 


Path points to a path name naming a file. Access 
checks the named file for accessibility according to the 
bit pattern contained in amode, using the real user ID in 
place of the effective user ID and the real group ID in 
place of the effective group ID. The bit pattern 
contained in amode is constructed as follows: 


04 read 

02 write 

01 execute (search) 

00 check existence of file 


Access to the file is denied if one or more of the 
following are true: 


ENOTDIR] A component of the path prefix is not a 
directory. 

ENOENT] Read, write, or execute (search) 
permission is requested for a null path 
name. 

ENOENT] The named file does not exist. 

EACCES] Search permission is denied on a 
component of the path prefix. 

EROFS] Write access is requested for a file on a 
read-only file system. 

ETXTBSY] 

Write access is requested for a pure 
procedure (shared text) file that is being 
executed. 

[EACCES] 

Permission bits of the file mode do not 
permit the requested access. 

[EFAULT] 


Path points outside the allocated 
address space for the process. 


The owner of a file has permission checked with respect 
to the ‘“‘owner’’? read, write, and execute mode bits. 
Members of the file’s group other than the owner have 
permissions checked with respect to the “group”? mode 
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bits, and all others have permissions checked with 
respect to the “other” mode bits. 


RETURN VALUE 
If the requested access is permitted, a value of 0 is 
returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
chmod(2), stat(2). 
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NAME 


ACCT (2) 


acct — enable or disable process accounting 


SYNOPSIS 


int acct (path) 
char *path; 


DESCRIPTION 


Acct is used to enable or disable the system process 
accounting routine. If the routine is enabled, an 
accounting record will be written on an accounting file 
for each process that terminates. Termination can be 
caused by one of two things: an ezté call or a signal; see 
ezit(2) and stgnal(2). The effective user ID of the calling 
process must be super-user to use this call. 


Path points to a path name naming the accounting file. 
The accounting file format is given in acct(4). 


The accounting routine is enabled if path is non-zero and 
no errors occur during the system call. It is disabled if 
path is zero and no errors occur during the system call. 


Acct will fail if one or more of the following are true: 


[EPERM] The effective user of the calling process 
is not super-user. 

[EBUSY] An attempt is being made to enable 
accounting when it is already enabled. 

[ENOTDIR] A component of the path prefix is not a 
directory. 

{ENOENT] One or more components of the 
accounting file path name do not exist. 

EACCES] A component of the path prefix denies 
search permission. 

EACCES] The file named by path is not an 
ordinary file. 

EACCES] Mode permission is denied for the 
named accounting file. 

EISDIR] The named file is a directory. 

EROFS] The named file resides on a read-only 
file system. 

EFAULT| Path points to an illegal address. 


RETURN VALUE 


Upon successful completion, a value of O is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


ACCT(2) 


SEE ALSO 
exit(2), signal(2), acct(4). 
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NAME 
alarm ~ set a process alarm clock 
SYNOPSIS 
unsigned alarm (sec) 
unsigned sec; 
DESCRIPTION 


Alarm instructs the alarm clock of the calling process to 
send the signal SIGALRM to the calling process after 
the number of real time seconds specified by sec have 
elapsed; see stgnal(2). 


Alarm requests are not stacked; successive calls reset the 
alarm clock of the calling process. 


If sec is 0, any previously made alarm request is 
canceled. 

RETURN VALUE 
Alarm returns the amount of time previously remaining 
in the alarm clock of the calling process. 

SEE ALSO 
pause(2), signal(2). 
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NAME 
bind — bind a name to a socket 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 


bind (s, name, namelen) 
int 8; 

struct sockaddr *name; 
int namelen; 


DESCRIPTION 
Bind assigns a name to an unnamed socket. When a 
socket is created with socket(2N), it exists in a name 
space (address family) but has no name assigned. Bind 
requests that name be assigned to the socket. 


NOTES 
The rules used in name binding vary between 
communication domains. Consult the manual entries in 
section 4 for detailed information. 


RETURN VALUE 
If the bind is successful, a O value is returned. A return 
value of —1 indicates an error, which is further specified 
in the global errno. 


ERRORS 
The bind call will fail if: 
EBADF] S is not a valid descriptor. 
[ENOTSOCK] S is not a socket. 


[EADDRNOTAVAIL] The specified address is not 


available from the local machine. 


[EADDRINUSE] The specified address is already in 
use. 

[EINVAL] The socket is already bound to an 
address. 

[EACCESS] The requested address is 


protected, and the current user 
has inadequate permission to 


access it. 

[EFAULT] The name parameter is not in a 
valid part of the user address 
space. 


SEE ALSO 
connect(2N), getsockname(2N), listen(2N), socket(2N). 
CTIX Internetworking Manual. 


5/86 a ae 


BIND (2N) 


NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


BRK(2) 


NAME 
brk, sbrk — change data segment space allocation 


SYNOPSIS 
int brk (endds) 
char *endds; 


char *sbrk (incr) 
int incr; 


DESCRIPTION 

Brk and sbrk are used to change dynamically the 
amount of space allocated for the calling process’s data 
segment; see ezec(2). The change is made by resetting 
the process’s break value and allocating the appropriate 
amount of space. The break value is the address of the 
first location beyond the end of the data segment. The 
amount of allocated space increases as the break value 
increases. The newly allocated space is set to zero. 


Brk sets the break value to endds and changes the 
allocated space accordingly. 


Sbrk adds iner bytes to the break value and changes the 
allocated space accordingly. Incr can be negative, in 
which case the amount of allocated space is decreased. 


Brk and sbrk will fail without making any change in the 
allocated space if one or more of the following are true: 


[ENOMEM|] 
Such a change would result in more space 
being allocated than is allowed by a system- 
imposed maximum (see ulimit(2)). Note that 
due to a lack of swap space this may be less 
than what ulimit(2) reports. 


[ENOMEM} 
Such a change would result in the break 
value being greater than or equal to the start 
address of any attached shared memory 
segment (see shmop(2)). 


RETURN VALUE 
Upon successful completion, brk returns a value of 0 and 
sbrk returns the old break value. Otherwise, a value of 
~1 is returned and errno is set to indicate the error. 

SEE ALSO 
exec(2). 
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NAME 
chdir — change working directory 


SYNOPSIS 
int chdir (path) 
char *path; 

DESCRIPTION 
Path points to the path name of a directory. Chdir 
causes the named directory to become the current 
working directory, the starting point for path searches 
for path names not beginning with /. 


Chdir will fail and the current working directory will be 
unchanged if one or more of the following are true: 


[ENOTDIR] A component of the path name is not a 
directory. 

[ENOENT} The named directory does not exist. 

[EACCES] Search permission is denied for any 
component of the path name. 

{EFAULT}] Path points outside the allocated 


address space of the process. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
chroot(2). 


CHMOD (2) 


NAME 
chmod — change mode of file 


SYNOPSIS 
int chmod (path, mode) 
char *path; 
int mode; 


DESCRIPTION 
Path points to a path name naming a file. Chmod sets 
the access permission portion of the named file’s mode 
according to the bit pattern contained in mode. 


Access permission bits are interpreted as follows: 


04000 Set user ID on execution. 

02000 Set group ID on execution. 

01000 Save text image after execution. 

00400 Read by owner. 

00200 Write by owner. 

00100 Execute (search if a directory) by owner. 
00070 Read, write, execute (search) by group. 
00007 ~=—~Read, write, execute (search) by others. 


The effective user ID of the process must match the 
owner of the file or be super-user to change the mode of 
a file. 


If the effective user ID of the process is not super-user, 
mode bit 01000 (save text image on execution) is cleared. 


If the effective user ID of the process is not super-user 
and the effective group ID of the process does not match 
the group ID of the file, mode bit 02000 (set group ID on 
execution) is cleared. 


If an executable file is prepared for sharing then mode 
bit 01000 prevents the system from abandoning the 
swap-space image of the program-text portion of the file 
when its last user terminates. Thus, when the next user 
of the file executes it, the text need not be read from the 
file system but can simply be swapped in, saving time. 


Chmod will fail and the file mode will be unchanged if 
one or more of the following are true: 


[ENOTDIR] A component of the path prefix is not a 
directory. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied on a 
component of the path prefix. 

{[EPERM] The effective user ID does not match 


the owner of the file and the effective 
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user ID is not super-user. 


[EROFS] The named file resides on a read-only 
file system. 
{EF AULT] Path points outside the allocated 


address space of the process. 
RETURN VALUE 
Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 
SEE ALSO 
chown(2), mknod(2). 


CHOWN (2) 


NAME 
chown — change owner and group of a file 


SYNOPSIS 
int chown (path, owner, group) 
char *path; 
int owner, group; 


DESCRIPTION 
Path points to a path name naming a file. The owner ID 
and group ID of the named file are set to the numeric 
values contained in owner and group respectively. 


Only processes with effective user ID equal to the file 
owner or super-user may change the ownership of a file. 


If chown is invoked by other than the super-user, the 
set-user-ID and set-group-ID bits of the file mode, 04000 
and 02000 respectively, will be cleared. 


Chown will fail and the owner and group of the named 
file will remain unchanged if one or more of the 
following are true: 


ENOTDIR} A component of the path prefix is not a 
directory. 

ENOENT] The named file does not exist. 

[EACCES] Search permission is denied on a 
component of the path prefix. 

EPERM| The effective user ID does not match 


the owner of the file and the effective 
user ID is not super-user. 


EROFS] The named file resides on a read-only 
file system. 
EFAULT] Path points outside the allocated 


address space of the process. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
chown(1), chmod(2). 


NAME 


CHROOT (2) 


chroot — change root directory 


SYNOPSIS 


int chroot (path) 
char *path; 


DESCRIPTION 


Path points to a path name naming a directory. Chroot 
causes the named directory to become the root directory, 
the starting point for path searches for path names 
beginning with /. The user’s working directory is 
unaffected by the chroot system call. 


The effective user ID of the process must be super-user to 
change the root directory. 


The .. entry in the root directory is interpreted to mean 
the root directory itself. Thus, .. cannot be used to 
access files outside the subtree rooted at the root 
directory. 


Chroot will fail and the root directory will remain 
unchanged if one or more of the following are true: 


[ENOTDIR} Any component of the path name is not 
a directory. 

[ENOENT| The named directory does not exist. 

[EPERM|] The effective user ID is not super-user. 

[EFAULT} Path points outside the allocated 


address space of the process. 


RETURN VALUE 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


chdir(2). 
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NAME 
close — close a file descriptor 


SYNOPSIS 
int close (fildes) 
int fildes; 


DESCRIPTION 
Fildes is a file descriptor obtained from a creat, open, 
dup, fentl, or ptpe system call. Close closes the file 
descriptor indicated by fildes. All outstanding record 
locks owned by the process (on the file indicated fildes) 
are removed. 


[EBADF] Close will fail if fildes is not a valid open file 
descriptor. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
creat(2), dup(2), exec(2), fentl(2), open(2), pipe(2). 


CONNECT (2N) 


NAME 
connect — initiate a connection on a socket 
; SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 
connect (s, name, namelen) 
int 8; 
struct sockaddr *name; 
int namelen; 
DESCRIPTION 


Connect initiates a connection on a socket. The 
parameter s is a socket. If it is of type SOCK_DGRAM, 
then this call permanently specifies the peer to which 
datagrams are to be sent; if it is of type 
SOCK_STREAM, then this call attempts to make a 
connection to another socket. The other socket is 
specified by name; namelen is the length of name. which 
is an address in the communications space of the socket. 
Each communications space interprets the name 
parameter in its own way. 


RETURN VALUE 


If the connection or binding succeeds, then 0 is returned. 
Otherwise a -1 is returned, and a more specific error 
code is stored in errno. 


ERRORS 
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The call fails if: 

[EBADF| S is not a valid descriptor. 

[ENOTSOCK] S is a descriptor for a file, not a 
socket. 


[(EADDRNOTAVAIL] The specified address is not 
available on this machine. 


[EAFNOSUPPORT] Addresses in the specified address 
family cannot be used with this 


socket. 
[EISCONN] The socket is already connected. 
{[ETIMEDOUT] Connection establishment timed 
out without establishing a 
connection. 


[ECONNREFUSED] The attempt to connect was 
forcefully rejected. 


[ENETUNREACH] _ The network is not reachable from 
this host. 
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[EADDRINUSE} The address is already in use. 
[EFAULT] The name parameter specifies an 
area outside the process address 
space. 
SEE ALSO 


accept(2N), getsockname(2N), socket(2N). 
CTIX Internetworking Manual. 


NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
creat — create a new file or rewrite an existing one 


SYNOPSIS 
int creat (path, mode) 
char *path; 
int mode; 


DESCRIPTION 
Creat creates a new ordinary file or prepares to rewrite 


an existing file named by the path name pointed to by 
path. 


If the file exists, the length is truncated to 0 and the 
mode and owner are unchanged. Otherwise, the file’s 
owner ID is set to the effective user ID, of the process the 
group ID of the process is set to the effective group ID, of 
the process and the low-order 12 bits of the file mode are 
set to the value of mode modified as follows: 


All bits set in the process’s file mode creation 
mask are cleared. See umask(2). 


The “‘save text image after execution bit” of the 
mode is cleared. See chmod(2). 


Upon successful completion, the file descriptor is 
returned and the file is open for writing, even if the 
mode does not permit writing. The file pointer is set to 
the beginning of the file. The file descriptor is set to 
remain open across erec system calls. See fentl(2). No 
process may have more than 20 files open 
simultaneously. A new file may be created with a mode 
that forbids writing. 


Creat will fail if one or more of the following are true: 


EACCES] Search permission is denied on a 
component of the path prefix. 

EACCES] The file does not exist and the directory 
in which the file is to be created does 
not permit writing. 

EACCES] The file exists and write permission is 
denied. 

ENOTDIR] A component of the path prefix is not a 
directory. 

ENOENT] A component of the path prefix does 
not exist. 

ENOENT] The path name is null. 

EROFS] The named file resides or would reside 


on a read-only file system. 
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ETXTBSY] The file is a pure procedure (shared 
text) file that is being executed. 

EISDIR] The named file is an existing directory. 

EMFILE] Twenty (20) file descriptors are 
currently open. 

EFAULT] Path points outside the allocated 
address space of the process. 

ENFILE] The system file table is full. 

EDEADLOCK} A side effect of a previous locking(2) 
call. 


RETURN VALUE 
Upon successful completion, a non-negative integer, 
namely the file descriptor, is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 
chmod(2), close(2), dup(2), fentl(2), locking(2), lseek(2), 
open(2), read(2), umask(2), write(2). 


NAME 


DUP(2) 


dup — duplicate an open file descriptor 


SYNOPSIS 


int dup (fildes) 
int fildes; 


DESCRIPTION 


Fildes is a file descriptor obtained from a creat, open, 
dup, fentl, or pipe system call. Dup returns a new file 
descriptor having the following in common with the 
original: 


Same open file (or pipe). 


Same file pointer (i.e., both file descriptors share 
one file pointer). 


Same access mode (read, write or read/write). 


The new file descriptor is set to remain open across exec 
system calls. See fenil(2). 


The file descriptor returned is the lowest one available. 
Dup will fail if one or more of the following are true: 


[EBADF] Fildes is not a valid open file 
descriptor. 
{EMFILE] Twenty (20) file descriptors are 


currently open. 


RETURN VALUE 


Upon successful completion a non-negative integer, 
namely the file descriptor, is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 


creat(2), close(2), exec(2), fentl(2), open(2), pipe(2). 


NAME 


EXEC(2) 


execl, execv, execle, execve, execlp, execvp — execute a 
file 


SYNOPSIS 


int exec] (path, argO, argl, ..., argn, 0) 

char *path, *targO, *argl, ..., *argn; 

int execv (path, argv) 

char *path, earevias 

int execle (path, argO, argl, ..., argn, 0, envp) 
char *path, *arg0, *argl, ..., *argn, *envp[ |; 
int execve (path, argv, envp) 

char *path, *argv{ ], Senvel lt 

int execlp (file, argO, argl, ..., argn, 0) 

char *file, *argO, *argl, ..., *argn; 

int execvp (file, argv) 

char ‘file, *argv[ }; 


DESCRIPTION 


Exec in all its forms transforms the calling process into a 
new process. The new process is constructed from an 
ordinary, executable file called the new process file. 
This file consists of a header (see a.out(4)), a text 
segment, and a data segment. The data segment 
contains an initialized portion and an_ uninitialized 
portion (bss). There can be no return from a successful 
exec because the calling process is overlaid by the new 
process. 


When a C program is executed, it is called as follows: 
main (arge, argv, envp) 
int arge; 
char **argv, **envp; 


where arge is the argument count and argv is an array of 
character pointers to the arguments themselves. As 
indicated, arge is conventionally at least one and the 
first member of the array points to a string containing 
the name of the file. 


Path points to a path name that identifies the new 
process file. 


File points to the new process file. The path prefix for 
this file is obtained by a search of the directories passed 
as the environment line "PATH =” (see envtron(5)). 
The environment is supplied by the shell (see sh(1)). 


Arg0, arg1, ..., argn are pointers to null-terminated 
character strings. These strings constitute the argument 
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list available to the new process. By convention, at least 
argO must be present and point to a string that is the 
same as path (or its last component). 


Argv is an array of character pointers to null-terminated 
strings. These strings constitute the argument list 
available to the new process. By convention, argv must 
have at least one member, and it must point to a string 
that is the same as path (or its last component). Argv is 
terminated by a null pointer. 


Envp is an array of character pointers to null-terminated 
strings. These strings constitute the environment for the 
new process. Envp is terminated by a null pointer. For 
ezecl and ezecv, the C run-time start-off routine places 
a pointer to the environment of the calling process in the 
global cell: 
extern char **environ; 

and it is used to pass the environment of the calling 
process to the new process. 


File descriptors open in the calling process remain open 
in the new process, except for those whose close-on-exec 
flag is set; see fentl(2). For those file descriptors that 
remain open, the file pointer is unchanged. 


Signals set to terminate the calling process will be set to 
terminate the new process. Signals set to be ignored by 
the calling process will be set to be ignored by the new 
process. Signals set to be caught by the calling process 
will be set to terminate the new process; see signal(2). 


If the set-user-ID mode bit of the new process file is set 
(see chmod(2)), exec sets the effective user ID of the new 
process to the owner ID of the new process file. 
Similarly, if the set-group-ID mode bit of the new process 
file is set, the effective group ID of the new process is set 
to the group ID of the new process file. The real user ID 
and real group ID of the new process remain the same as 
those of the calling process. 


The shared memory segments attached to the calling 
process will not be attached to the new process (see 
shmop(2)). 


Profiling is disabled for the new process; see profil(2). 


The new process also inherits the following attributes 
from the calling process: 


nice value (see nice(2)) 
process ID 
parent process ID 
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process group ID 

semadj values (see semop(2) 

tty group ID (see ezit(2) and stgnal(2)) 

trace flag (see ptrace(2) request 0) 

time left until an alarm clock signal (see 
alarm(2)) 

current working directory 

root directory 

file mode creation mask (see umask(2)) 

file size limit (see ulimst(2)) 

utime, stime, cuttme, and cstime (see times(2)) 


Exec will fail and return to the calling process if one or 
more of the following are true: 


ENOENT] 


ENOTDIR] 


EACCES] 


EACCES| 
EACCES| 


ENOEXEC} 


ETXTBSY| 


ENOMEM] 


[E2BIG| 


One or more components of the new 
process path name of the file do not 
exist. 


A component of the new process path of 
the file prefix is not a directory. 


Search permission is denied for a 
directory listed in the new process file’s 
path prefix. 


The new process file is not an ordinary 
file. 


The new process file mode denies 
execution permission. 


The exec is not an ezeclp or ezxecup, 
and the new process file has the 
appropriate access permission but an 
invalid magic number in its header. 


The new process file is a pure procedure 
aah text) file that is currently open 
or writing by some process. 


The new process requires more memory 
than is allowed by the system-imposed 
maximum. ‘This limit is a configurable 
quantity up to the limitations of the 
hardware. It may be less due to 
restrictions on swap space. 


The number of bytes in the new 
process’s argument list is greater than 
the system-imposed limit of 10,240 
bytes. 


{EFAULT] 


[EFAULT] 


[ENOHDW] 


|ENOEXEC] 


[ENOEXEC] 


[EPERM] 


RETURN VALUE 
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The new process file is not as long as 
indicated by the size values in _ its 


header. 


Path, argv, or envp point to an illegal 
address. 


The executable file requires hardware 
that does not exist (such as floating- 
point). 

The file format does not correspond to 
that expected as specified with the 


magic number (such as a hole in the 
file). 


The virtual address specification in the 
header(s) exceeds the allowed system 
limits. 

The process is being traced (see 
ptrace(2)), but the file does not permit 
reading. 


If exec returns to the calling process an error has 
occurred; the return value will be —1 and errno will be 
set to indicate the error. 


SEE ALSO 


sh(1), alarm(2), 


semop(2), 
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signal(2), times(2), ulimit(2),  umask(2 
a.out(4), environ(5). 


, 


exit(2), fork(2), nice(2), ba 


? 
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NAME 
exit, _exit — terminate process 


SYNOPSIS 
void exit (status) 
int status; 
void _exit (status) 
int status; 


DESCRIPTION 


Exit terminates the calling process with the following 
consequences: 


All of the file descriptors open in the calling 
process are closed. 


If the parent process of the calling process is 
executing a wait, it is notified of the calling 
process’s termination and the low order eight 
bits (i.e., bits 0377) of status are made available 
to it; see watt(2). 

If the parent process of the calling process is not 
executing a wart, the calling process is 
transformed into a zombie process. A zombie 
process is a process that only occupies a slot in 
the process table. It has no other space 
allocated either in user or kernel space. The 
process table slot that it occupies is partially 
overlaid with time accounting information (see 
<sys/proc.h>) to be used by times. 


The parent process ID of all of the calling 
process’s existing child processes and zombie 
processes is set to 1. This means that the 
initialization process (see intro(2)) inherits each 
of these processes. 


Each attached shared memory segment is 
detached and the value of shm_nattach in the 
data structure associated with its shared memory 
identifier is decremented by 1. 


For each semaphore for which the calling process 
has set a semadj value (see semop(2)), that 
semadj value is added to the semval of the 
specified semaphore. 


If the process has a process, text, or data lock, 
an unlock is performed (see plock(2)). 


An accounting record is written on the 
accounting file if the system’s accounting routine 
is enabled; see acct (2). 
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If the process ID, tty group ID, and process group 
ID of the calling process are equal (i.e., it is a 
process group leader), the SIGHUP signal is sent 
to each process that has a process group ID equal 
to that of the calling process. 


If the process is a process group leader, all 
processes in its group are made members of the 
null group. 


The C function eztt may cause cleanup actions before 
the process exits. The function _eztt circumvents all 
cleanup. 


SEE ALSO 

intro(2), acct(2), plock(2), semop(2), signal(2), wait(2). 
WARNING 

See WARNING in signal(2). 


NAME 


FCNTL(2) 


fentl — file control 


SYNOPSIS 


#include <fentl.h> 


int fcntl (fildes, cmd, arg) 
int fildes, emd, arg; 


DESCRIPTION 


Fentl provides for control over open files. Fildes is an 
open file descriptor obtained from a creat, open, dup, 
fentl, or pipe system call. 


The commands available are: 


F_DUPFD 


F_GETFD 


F_SETFD 


F_GETFL 
F_SETFL 


F_GETLK 


Return a new file descriptor as follows: 
Lowest numbered available file 
descriptor greater than or equal to arg. 


Same open file (or pipe) as the original 
file. 


Same file pointer as the original file (i.e., 
both file descriptors share one file 
pointer). 


Same access mode (read, write or 
read/write). 


Same file status flags (i.e., both file 
descriptors share the same file status 
flags). 

The close-on-exec flag associated with 
the new file descriptor is set to remain 
open across ezec(2) system calls. 


Get the close-on-exec flag associated 
with the file descriptor fildes. If the 
low-order bit is O the file will remain 
open across ezec, otherwise the file will 
be closed upon execution of ezec. 


Set the close-on-exec flag associated with 
fildes to the low-order bit of arg (O or 1 
as above). 

Get file status flags. 


Set file status flags to arg. Only certain 
flags can be set; see fentl(5). 

Get the first lock which blocks the lock 
description given by the variable of type 
struct flock pointed to by arg (see 
fentl(5)). The information retrieved 
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overwrites the information passed to 
fentl in the flock structure. If no lock is 
found that would prevent this lock from 
being created, then the structure is 
passed back unchanged except for the 
lock type which will be set. to F_UNLCK. 


F_SETLK Set or clear a file segment lock 
according to the variable of type struct 
flock pointed to by arg [see srk 
The cmd F_SETLK is used to establis 
read (F_RDLCK) and write (F_WRLCK) 
locks, as well as remove either type of 
lock (F_LUNLCK). If a read or write lock 
cannot be set, fentl will return 
immediately with an error value of —1. 


F_SETLKW This cmd is the same as F_SETLK except 
that if a read or write lock is blocked by 
other locks, the process will sleep until 
the segment is free to be locked. 


A read lock prevents any process from write locking the 
protected area. More than one read lock may exist for a 
given segment of a file at a given time. The file 
descriptor on which a read lock is being placed must 
have been opened with read access. 


A write lock prevents any process from read locking or 
write locking the protected area. Only one write lock 
may exist for a given segment of a file at a given time. 
The file descriptor on which a write lock is being placed 
must have been opened with write access. 


The structure flock describes the type (_type), starting 
offset (I_whence), relative offset (l_start), size ({_len), and 
process id ((_ptd) of the segment of the file to be 
affected. The process id field is only used with the 
F_GETLK emd to return the value for a block in lock. 
Locks may start and extend beyond the current end of a 
file, but may not be negative relative to the beginning of 
the file. A lock may be set to always extend to the end 
of file by setting /_len to zero (0). If such a lock also has 
l_start set to zero (0), the whole file will be locked. 
Changing or unlocking a segment from the middle of a 
larger locked segment leaves two smaller segments for 
either end. Locking a segment that is already locked by 
the calling process causes the old lock type to be 
removed and the new lock type to take effect. All locks 
associated with a file for a given process are removed 
when a file descriptor for that file is closed by that 
process or the process holding that file descriptor 
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terminates. Locks are not inherited by a child process in 
a fork(2) system call. 


Fentl will fail if one or more of the following are true: 


[EBADF] 
[EMFILE| 
{EINFILE] 


[EINVAL] 


(EACCES| 


[EMFILE] 


[ENOSPC} 


{EDEADLK] 


RETURN VALUE 


Fildes is not a valid open file 
descriptor. 


Cmd is F_DUPFD and 20 file descriptors 
are currently open. 


Cmd is F_DUPFD and arg is negative or 
greater than 20. 


Cmd is F_GETLK, F_SETLK, or 
SETLKW and arg or the data it points 
to is not valid. 


Cmd is F_SETLK; the type of lock 
l_type) is a read (F_RDLCK) or write 
F_WRLCK lock, and the segment of a 
ile to be locked is already write locked 
by another process; or the type is a 
write lock, and the segment of a file to 
be locked is already read or write 
locked by another process. 


Cmd is F_SETLK or F_SETLKW, the 
type of lock is a read or write lock and 
there are no more file locking headers 
available (too many files have segments 
locked). 


Cmd is F_SETLK or F_SETLKW, the 
type of lock is a read or write lock and 
there are no more file locking headers 
available (too many files have segments 
locked) or there are no more record 
locks available (too many file segments 
locked). 


Cmd is F_SETLK, when the lock is 
blocked by some lock from another 
process and sleeping (waiting) for that 
lock to become free, this causes a 
deadlock situation. 


Upon successful completion, the value returned depends 
on emd as follows: 

F_DUPFD A new file descriptor. 

F_GETFD Value of flag (only the low-order 


bit is defined). 
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F_SETFD Value other than —1. 
F_GETFL Value of file flags. 

F_SETFL Value other than —1. 
F_GETLK Value other that —1. 
F_SETLK Value other than -1. 


F_SETLKW Value other than -1. 


Otherwise, a value of ~1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
close(2), exec(2), open(2), fentl(5). 
BUGS 


Two forms of file locking are available: locking(2) and 
fentl(2). These two methods are not compatible; a lock 
by one is not honored by the other. 
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NAME 
fork — create a new process 


SYNOPSIS 
int fork () 


DESCRIPTION 
Fork causes creation of a new process. The new process 
child process) is an exact copy of the calling process 
parent process). This means the child process inherits 
the following attributes from the parent process: 


environment 
close-on-exec flag (see ezec(2)) 
signal handling settings (ie., SIG_DFL, 
SIG_IGN, function address) 
set-user-ID mode bit 
set-group-ID mode bit 
profiling on/off status 
nice value (see nice(2)) 
all attached shared memory segments (see 
shmop(2)) 
process group ID 
tty group ID (see eztt(2) and stgnal(2)) 
trace flag (see ptrace(2) request 0) 
time left until an alarm clock signal (see 
alarm(2)) 
current working directory 
root directory 
file mode creation mask (see umask(2)) 
file size limit (see ultmst(2)) 
The child process differs from the parent process in the 
following ways: 


The child process has a unique process ID. 
The child process has a different parent process 
ID (i.e., the process ID of the parent process). 


The child process has its own copy of the 
parent’s file descriptors. Each of the child’s file 
descriptors shares a common file pointer with 
the corresponding file descriptor of the parent. 


All semadj values are cleared (see semop(2)). 


Process locks, text locks and data locks are not 
inherited by the child plock(2)). 


The child process’s utime, sttme, cuttme, and 
cstime are set toO. The time left until an alarm 
clock signal is reset to 0. 
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Fork will fail and no child process will be created if one 
or more of the following are true: 


{EAGAIN] The system-imposed limit on the total 
number of processes under execution 
would be exceeded. 


|EAGAIN] The system-imposed limit on the total 
number of processes under execution by 
a single user would be exceeded. 


RETURN VALUE 
Upon successful completion, fork returns a value of 0 to 
the child process and returns the process ID of the child 
process to the parent process. Otherwise, a value of —1 
is returned to the parent process, no child process is 
created, and errno is set to indicate the error. 


SEE ALSO 
exchanges(2), exec(2), nice(2), plock(2), _ ptrace(2), 
semop(2), shmop(2), signal(2), times(2), ulimit(2 
umask(2), wait(2). 


, 
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NAME 

getpeername — get name of connected peer 
SYNOPSIS 

getpeername(s, name, namelen) 

int 8; 


struct sockaddr *name; 
int *namelen; 


DESCRIPTION 
Getpeername returns the name of the peer connected to 
socket 8. The namelen parameter should be initialized 
to indicate the amount of space pointed to by name. On 
return it contains the actual size of the name returned 


(in bytes). 
DIAGNOSTICS 

A 0 is returned if the call succeeds, —1 if it fails. 
ERRORS 

The call succeeds unless: 

EBADF] The argument ¢ is not a_ valid 


descriptor. 
ENOTSOCK] The argument s is a file, not a socket. 
ENOTCONN] The socket is not connected. 


ENOBUFS] Insufficient resources were available in 
the system to perform the operation. 


EFAULT] The name parameter points to memory 
not in a valid part of the process 
address space. 


SEE ALSO 
bind(2N), socket(2N), getsockname(2N). 
CTIX Internetworking Manual. 

NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
getpid, getpgrp, getppid — get process, process group, 
and parent process IDs 


SYNOPSIS 
int getpid () 
int getpgrp () 
int getppid () 

DESCRIPTION 
Getpid returns the process ID of the calling process. 
Getpgrp returns the process group ID of the calling 
process. 
Getppid returns the parent process ID of the calling 
process. 


SEE ALSO 
exec(2), fork(2), intro(2), setpgrp(2), signal(2). 
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NAME 
getsockname — get socket name 
SYNOPSIS 
getsockname(s, name, namelen) 
int 8; 


struct sockaddr *name; 
int *namelen; 


DESCRIPTION 
Getsockname returns the current name for the specified 
socket (s). The namelen parameter should be initialized 
to indicate the amount of space pointed to by name. On 
return namelen contains the actual size of the name 
returned (in bytes). 


RETURN VALUE 
A 0 is returned if the call succeeds, —1 if it fails. 


ERRORS 
The call succeeds unless: 
[EBADF] The argument s is not a_ valid 
descriptor. 
[ENOTSOCK} The argument s is a file, not a socket. 
[ENOBUFS] Insufficient resources were available in 
the system to perform the operation. 
[EFAULT] The name parameter points to memory 
not in a valid part of the process 
address space. 
SEE ALSO 


bind(2N), socket(2N). 
CTIX Internetworking Manual. 
NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
getsockopt, setsockopt — get and set options on sockets 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 


getsockopt(s, level, optname, optval, optlen) 
int s, level, optname; 

char “*optval; 

int *optlen; 


setsockopt(s, level, optname, optval, optlen) 
int s, level, optname; 

char *optval; 

int optlen; 


DESCRIPTION 
Getsockopt and setsockopt manipulate opttons associated 
with a socket. Options may exist at multiple protocol 
levels; they are always present at the uppermost 
“socket’’ level. 


When manipulating socket options the level at which the 
option resides and the name of the option must be 
specified. To manipulate options at the ‘‘socket’’ level, 
level is specified as SOL_SOCKET. To manipulate 
options at any other level the protocol number of the 
appropriate protocol controlling the option is supplied. 
For example, to indicate an option is to be interpreted 
by the TCP protocol, level should be set to the protocol 
number of TCP; see getprotoent(3N). 


The parameters optval and optlen are used to access 
option values for setsockopt. For getsockopt they 
identify a buffer in which the value for the requested 
sptionis) are to be returned. For getsockopt, optlen is a 
value-result parameter, initially containing the size of 
the buffer pointed to by optval, and modified on return 
to indicate the actual size of the value returned. If no 
option value is to be supplied or returned, optval may be 
supplied as 0. 


Optname and any specified options are passed 
uninterpreted to the appropriate protocol module for 
interpretation. The include file < sys/socket.h > 
contains definitions for ‘‘socket’’ level options; see 
socket(2N). Options at other protocol levels vary in 
format and name, consult the appropriate entries in 
(4N). 
RETURN VALUE 
A Ois returned if the call succeeds, —1 if it fails. 
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ERRORS 
The call succeeds unless: 
[EBADF] The argument s is not a valid 
descriptor. 
[ENOTSOCK] The argument s is a file, not a woe 
socket. 
[ENOPROTOOPT] The option is unknown. 
[EFAULT] The options are not in a valid 
part of the process address space. 
SEE ALSO 


socket(2N), getprotoent(3N). 
CTIX Internetworking Manual. 
NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
getuid, geteuid, getgid, getegid — get real user, effective 
user, real group, and effective group IDs 


SYNOPSIS 
unsigned short getuid () 


unsigned short geteuid () 
unsigned short getgid () 
unsigned short getegid () 


DESCRIPTION 
Getutd returns the real user ID of the calling process. 


Geteutd returns the effective user ID of the calling 
process. 


Getgtd returns the real group ID of the calling process. 


Getegid returns the effective group ID of the calling 
process. 

SEE ALSO 
intro(2), setuid(2). 


IOCTL(2) 


NAME 
ioctl — control device 

SYNOPSIS 
ioctl (fildes, request, arg) 
int fildes, request; 

DESCRIPTION 
Toctl performs a variety of functions on character special 
files (devices). The write-ups of various devices in 
Section 7 discuss how toctl applies to them. 


Toctl will fail if one or more of the following are true: 


[EBADF] Fildes is not a valid open file 
descriptor. 


[ENOTTY] Fildes is not associated with a character 
special device. 


[EINVAL] Request or arg is not valid. See 
Section 7. 

[EINTR] A signal was caught during the toctl 
system call. 

[EFAULT] The options are not in a valid part of 


the process address space. 


RETURN VALUE 
If an error has occurred, a value of —1 is returned and 
errno is set to indicate the error. 

SEE ALSO 
termio(7). 
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NAME 


KILL(2) 


kill — send a signal to a process or a group of processes 


SYNOPSIS 


int kill (pid, sig) 
int pid, sig; 


DESCRIPTION 


Kill sends a signal to a process or a group of processes. 
The process or group of processes to which the signal is 
to be sent is specified by pid. The signal that is to be 
sent is specified by sig and is either one from the list 
given in stgnal(2), or 0. If stg is O (the null signal), error 
checking is performed but no signal is actually sent. 
This can be used to check the validity of pid. 


The real or effective user ID of the sending process must 
match the real or effective user ID of the receiving 
process, unless the effective user ID of the sending 
process is super-user. 


The processes with a process ID of 0 and a process ID of 
1 are special processes (see tntro(2)) and will be referred 
to below as procO and proc1, respectively. 


If pid is greater than zero, stg will be sent to the process 
whose process ID is equal to ptd. Pid may equal 1. 


If ptd is 0, stg will be sent to all processes excluding 
procO and proci1 whose process group ID is equal to the 
process group ID of the sender. 


If ptd is -1 and the effective user ID of the sender is not 
super-user, stg will be sent to all processes excluding 
procO and proci! whose real user ID is equal to the 
effective user ID of the sender. 


If ptd is -1 and the effective user ID of the sender is 
super-user, stg will be sent to all processes excluding 
procO and procl. 


If ptd is negative but not —1, stg will be sent to all 
processes whose process group ID is equal to the absolute 
value of pid. 


Kill will fail and no signal will be sent if one or more of 
the following are true: 


[EINVAL] Sig is not a valid signal number. 

[EINVAL] Sig is SIGKILL and pid is 1 (proc1). 

[ESRCH] No process can be found corresponding 
to that specified by pid. 

[EPERM] The user ID of the sending process is 


not super-user, and its real or effective 
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user ID does not match the real or 
effective user ID of the receiving 
process. 


RETURN VALUE 
Upon successful completion, a value of O is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
kill(1), getpid(2), setpgrp(2), signal(2). 
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NAME 
drvalloc, drvbind — access loadable drivers 


SYNOPSIS 
#include <sys/types.h> 
#include <syslocal.h> 
#include <sys/drv.h> 


syslocal (SYSL_ALLOCDRY, option, ds) 
int option; 
struct drvalloc *ds; 


syslocal (SYSL_BINDDRYV, option, ds) 
int option; 
struct drvbind *ds; 

DESCRIPTION 
These two functions accessed via syslocal(2) implement 
the loadable driver functions of CTIX. They both require 
super-user privilege. 
Loading drivers consists of two phases: allocation of 
virtual space, device numbers, and device IDs; and 
binding. Fully relocating a driver into memory, 
allocating physical space, plugging the device switch 
tables, calling initialization routines, and unloading 
require the same two phases in reverse. 


SEE ALSO 
Ildrv(1M), syslocal(2). 


NAME 


LINK (2) 


link —- link to a file 


SYNOPSIS 


int link (path1, path2) 
char *pathl, *path2; 


DESCRIPTION 


Path1 points to a path name naming an existing file. 
Path2 points to a path name naming the new directory 
entry to be created. Link creates a new link (directory 
entry) for the existing file. 


Link will fail and no link will be created if one or more 
of the following are true: 


ENOTDIR} 
ENOENT| 
EACCES|] 


ENOENT] 
EEXIST] 
EPERM] 


EXDEV] 


ENOENT]| 
EACCES| 


EROFS|] 


EFAULT| 


EMLINK|] 


RETURN VALUE 


A component of either path prefix is 
not a directory. 


A component of either path prefix does 
not exist. 

A component of either path prefix 
denies search permission. 

The file named by path1 does not exist. 
The link named by path2 exists. 

The file named by path is a directory 


and the effective user ID is not super- 
user. 


The link named by path? and the file 
named by path1 are on different logical 
devices (file systems). 


Path2 points to a null path name. 


The requested link requires writing in a 
directory with a mode that denies write 
permission. 


The requested link requires writing in a 
directory on a read-only file system. 


Path points outside the allocated 
address space of the process. 


The maximum number of links to a file 
would be exceeded. 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
unlink(2). 
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NAME 
listen — listen for connections on a socket 


SYNOPSIS 
listen (s, backlog) 
int s, backlog; 


DESCRIPTION 
To accept connections, a socket is first created with 
socket(2N), a backlog for incoming connections is 
specified with listen, and then the connections are 
accepted with accept(2N). The listen call applies only to 
sockets of type SOCK_STREAM or 
SOCK_PKTSTREAM. 


The backlog parameter defines the maximum length to 
which the queue of pending connections may grow. If a 
connection request arrives with the queue full the client 
will receive an error with an_ indication of 


ECONNREFUSED. 


RETURN VALUE 
A 0 return value indicates success; ~1 indicates an error. 


ERRORS 
The call fails if: 
[EBADF] The argument s is not a valid 
descriptor. 
[ENOTSOCK] The argument s is not a socket. 


[EOPNOTSUPP] The socket is not of a type that 


supports the operation listen. 


SEE ALSO 
accept(2N), connect(2N), socket(2N). 
CTIX Internetworking Manual. 


BUGS 
The backlog is currently limited (silently) to 5. 


NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 


locking — exclusive access to regions of a file 


SYNOPSIS 
int locking (filedes, mode, size); 
int fildes, mode; 
long size; 


DESCRIPTION 

Locking places or removes a kernel-enforced lock on a 
region of a file. The calling process has exclusive access 
to regions it has locked. If another process uses read(2), 
write(2), creat(2), or open(2) (with O_TRUNC ) in a 
way that reads or modifies part of the locked region, the 
second process’s system call does not return until the 
lock is released, unless deadlock or some other error is 
detected. A process whose execution is suspended in 
such a manner is said to be blocked. 


Parameters specify the file to be locked or unlocked, the 
kind of lock or unlock, and the region affected: 


° Filedes specifies the file to be locked or 
unlocked; filedes is a file descriptor 
returned by an open, create, pipe, fentl, 
or dup system call. 


° Mode specifies the action: O for lock 
removal; 1 for blocking lock; 2 for 
checking lock. Blocking and checking 
locks differ only if the attempted lock is 
itself locked out: a blocking lock waits 
until the existing lock or locks are 
removed; a checking lock immediately 
returns an error. 


e The region affected begins at the current 
file offset associated with filedes and is 
size bytes long. If stze is zero, the 
region affected ends at the end of the 
file. 


Locking imposes no structure on a CTIX file. A process 
can arbitrarily lock any unlocked byte and unlock any 
locked byte. However, creating a large number of 
noncontiguous locked regions can fill up the system’s 
lock table and make further locks impossible. It is 
advisable that a program’s use of locking segment the file 
in the same way as does the program’s use of read and 
write. 


A process is said to be deadlocked if it is sleeping until 
an unlocking which is indirectly prevented by that same 
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sleeping process. The kernel will not permit a read, 
write, creat, open with O_TRUNC, or blocking locking 
if such a call would deadlock the calling process. Errno 
is set to EDEADLOCK. The standard response to such 
a situation is for the program to release all its existing 
locked areas and try again. If a locking call fails because 
the kernel’s table of locked areas is full, again, errno is 
set to EDEADLOCK and, again, the calling program 
should release its existing locked areas. 


Special files and pipes can be locked, but no 
input/output is blocked. 
Locks are automatically removed if the process that 
placed the lock terminates or closes the file descriptor 
used to place the lock. 
SEE ALSO 
create(2), close(2), dup(2), open(2), read(2), write(2). 
RETURN VALUE 
A return value of -1 indicates an error, with the error 
value in errno. 
[EACCES] A checking lock on a region already 
locked. 
[EDEADLOCK] A lock that would cause deadlock or 
overflow the system’s lock table. 
WARNING 
Do not apply any standard input/output library function 
to a locked file: this library does not know about locking. 
BUGS 
Two forms of file locking are available: locking(2) and 


fentl(2). These two methods are not compatible; a lock 
by one is not honored by the other. 
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NAME 
lseek — move read/write file pointer 
SYNOPSIS 
long Iseek (fildes, offset, whence) 
int fildes; 
long offset; 
int whence; 
DESCRIPTION 
Fildes is a file descriptor returned from a creat, open, 


dup, or fentl system call. Lseek sets the file pointer 
associated with fildes as follows: 


If whence is O, the pointer is set to offset bytes. 


If whence is 1, the pointer is set to its current 
location plus offset. 


If whence is 2, the pointer is set to the size of 
the file plus offset. 


Upon successful completion, the resulting pointer 
location, as measured in bytes from the beginning of the 
file, is returned. 


Lseek will fail and the file pointer will remain unchanged 
if one or more of the following are true: 


[EBADF] Fildes is not an open file descriptor. 
[ESPIPE] Fildes is associated with a pipe or fifo. 
[EINVAL and SIGSYS signal] 

Whence is not 0, 1, or 2. 
[EINVAL] The resulting file pointer would be 


negative. 


Some devices are incapable of seeking. The value of the 

file pointer associated with such a device is undefined. 
RETURN VALUE 

Upon successful completion, a non-negative integer 

indicating the file pointer value is returned. Otherwise, 

a value of —1 is returned and errno is set to indicate the 

error. 


SEE ALSO 
creat(2), dup(2), fentl(2), open(2). 
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NAME 
mknod — make a directory, or a special or ordinary file 


a“ SYNOPSIS 
int mknod (path, mode, dev) 
char *path; 
int mode, dev; 


DESCRIPTION 
Mknod creates a new file named by the path name 
pointed to by path. The mode of the new file is 
initialized from mode. Where the value of mode is 
interpreted as follows: 
0170000 file type; one of the following: 
0010000 fifo special 
0020000 character special 
0040000 directory 
0060000 block special 
0100000 or 0000000 ordinary file 
0004000 set user ID on execution 
0002000 set group ID on execution 
0001000 save text image after execution 
0000777 access permissions; constructed from the 
~_— following 
0000400 read by owner 
0000200 write by owner 
0000100 execute (search on directory) by owner 
0000070 read, write, execute (search) by group 
0000007 read, write, execute (search) by others 


The owner ID of the file is set to the effective user ID of 
the process. The group ID of the file is set to the 
effective group ID of the process. 


Values of mode other than those above are undefined 
and should not be used. The low-order 9 bits of mode 
are modified by the process’s file mode creation mask: all 
bits set in the process’s file mode creation mask are 
cleared. See umask(2). If mode indicates a block or 
character special file, dev is a configuration-dependent 
specification of a character or block I/O device. If mode 
does not indicate a block special or character special 
device, dev is ignored. 


Mknod may be invoked only by the super-user for file 
a types other than FIFO special. 


Mknod will fail and the new file will not be created if 
one or more of the following are true: 


{EPERM| The effective user ID of the process is 
not super-user. 


ENOTDIR] 
ENOENT] 
EROFS] 


EEXIST] 
EFAULT] 


RETURN VALUE 
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A component of the path prefix is not a 
directory. 


A component of the path prefix does 
not exist. 


The directory in which the file is to be 
created is located on a read-only file 
system. 


The named file exists. 


Path points outside the allocated 
address space of the process. 


Upon successful completion a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


mkdir(1), chmod(2), exec(2), umask(2), fs(4). 


a 


NAME 


MOUNT(2) 


mount — mount a file system 


SYNOPSIS 


int mount (spec, dir, rwflag) 
char *spec, *dir; 
int rwflag; 


DESCRIPTION 
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Mount requests that a removable file system contained 
on the block special file identified by spec be mounted 
on the directory identified by dir. Spec and dir are 
pointers to path names. 


Upon successful completion, references to the file dir will 
refer to the root directory on the mounted file system. 


The low-order bit of rwflag is used to control write 
permission on the mounted file system; if 1, writing is 
forbidden, otherwise writing is permitted according to 
individual file accessibility. 


Mount may be invoked only by the super-user. 
Mount will fail if one or more of the following are true: 


EPERM} The effective user ID is not super-user. 

ENOENT| Any of the named files does not exist. 

ENOTDIR] A component of a path prefix is not a 
directory. 

ENOTBLK} Spec is not a block special device. 

ENXIO] The device associated with spec does 
not exist. 

[ENOTDIR}] Dir is not a directory. 

[EFAULT] Spec or dtr points outside the allocated 


address space of the process. 


[EBUSY] Dir is currently mounted on, is 
someone’s current working directory, or 
is otherwise busy. 

EBUSY] The device associated with spec is 
currently mounted. 


EBUSY] There are no more mount table entries. 


EROFS] The low-order bit of rwflag is zero and 
the volume containing the file system is 
physically write-protected. 


EBADFS] An attempt to mount a bit-mapped file 
system failed due to the dirty flag being 
set for that file system. 


MOUNT (2) 


[ENXIO} The device is a swap partition. 

[ENXIO] The superblock found on the specified 
device does not have a correct magic 
number. 


RETURN VALUE 
Upon successful completion a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 
umount(2). 
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NAME 


MSGCTL(2) 


msgctl — message control operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/msg.h> 

int msgctl (msqid, cmd, buf) 
int msqid, cmd; 

struct msqid_ds *buf; 


DESCRIPTION 


Msgctl provides a variety of message control operations 
as specified by emd. The following cmds are available: 


IPC_STAT 


IPC_SET 


IPC_RMID 


Place the current value of each member 
of the data structure associated with 
msqid into the structure pointed to by 
buf. The contents of this structure are 
defined in tntro(2). {READ} 


Set the value of the following members 
of the data structure associated with 
msqtd to the corresponding value found 
in the structure pointed to by buf: 


msg_perm.uid 

msg_perm.gid 

msg_perm.mode /* only low 9 bits */ 
msg_qbytes 


This emd can only be executed by a 
process that has an effective user ID 
equal to either that of super user or to 
the value of msg_perm.uid in the data 
structure associated with msgid. Only 
super user can raise the value of 
msg_qbytes. 


Remove the message queue identifier 
specified by msqtd from the system and 
destroy the message queue and data 
structure associated with it. This emd 
can only be executed by a process that 
has an effective user ID equal to either 
that of super user or to the value of 
msg_perm.uid in the data structure 
associated with msqid. 


Msgcil will fail if one or more of the following are true: 


EINVAL] 


EINVAL] 
EACCES] 


EPERM] 


[EPERM|] 


[EFAULT] 
RETURN VALUE 
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Msqtd is not a valid message queue 
identifier. 


Cmd is not a valid command. 


Cmd is equal to IPC_LSTAT and 
{READ} operation permission is denied 
to the calling process (see tntro(2)). 


Cmd is equal to IPC_RMID or 
IPC_SET. The effective user ID of the 
calling process is not equal to that of 
super user and it is not equal to the 
value of msg_perm.uid in the data 
structure associated with msqtd. 


Cmd is equal to IPC_SET, an attempt 
is being made to increase to the value 
of msg _qbytes, and the effective user 
ID of the calling process is not equal to 
that of super user. 


Buf points to an illegal address. 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


intro(2), msgget(2), msgop(2). 
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NAME 
msgget — get message queue 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipe.h> 
#include <sys/msg.h> 


int msgget (key, msgflg) 
key_t key; 
int msgflg; 
DESCRIPTION 
Msgget returns the message queue identifier associated 
with key. 


A message queue identifier and associated message queue 
and data structure (see intro(2)) are created for key if 
one of the following are true: 


Key is equal to IPC_PRIVATE. 


Key does not already have a message queue 
identifier associated with it, and (msgflg & 
IPC_CREAT) is “‘true’’. 


Upon creation, the data structure associated with the 
new message queue identifier is initialized as follows: 


Msg_perm.cuid, msg_perm.uid, 
msg_perm.cgid, and msg_perm.gid are set 
equal to the effective user ID and effective group 
ID, respectively, of the calling process. 


The low-order 9 bits of msg_perm.mode are 
set equal to the low-order 9 bits of msgflg. 
Msg_qnum, msg_Ispid, msg_Irpid, 
msg_stime, and msg_rtime are set equal to 0. 
Msg_ctime is set equal to the current time. 
Msg_qbytes is set equal to the system limit. 
Msgget will fail if one or more of the following are true: 


[EACCES} A message queue identifier exists for 
key, but operation permission (see 
intro(2)) as specified by the low-order 9 
bits of msgflg would not be granted. 


[ENOENT} A message queue identifier does not 
exist for key and (msgflg & 
IPC_CREAT) is “‘false”’. 


[ENOSPC} A message queue identifier is to be 
created but the system-imposed limit on 
the maximum number of allowed 
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Message queue identifiers system wide 
would be exceeded. 


[EEXIST] A message queue identifier exists for key 
but ( (megflg & IPC_CREAT) & (msgflg 
& IPC_EXCL) ) is “true”. 

RETURN VALUE 

Upon successful completion, a non-negative integer, 

namely a message queue identifier, is returned. 

Otherwise, a value of —1 is returned and errno is set to 

indicate the error. 


SEE ALSO 
intro(2), msgctl(2), msgop(2). 


NAME 


MSGOP (2) 


msgop — message operations 


SYNOPSIS 


#include <sys/types.h> 

#include <sys/ipe.h> 

#include <sys/msg.h> 

int msgsnd (msqid, msgp, msgsz, msgfig) 
int msgid; 

struct msgbuf *msgp; 

int msgsz, msgflg; 


int msgrcv (msqid, msgp, msgsz, msgtyp, msgflg) 
int msgid; 

struct msgbuf *msgp; 

int msgsg; 

long msgtyp; 

int msgflg; 


DESCRIPTION 


Msgsnd is used to send a message to the queue associated 
with the message queue identifier specified by msgid. 
{WRITE} Msgp points to a structure containing the 
message. This structure is composed of the following 
members: 


long mtype; /* message type */ 

char mtext/; /* message text */ 
Mtype is a positive integer that can be used by the 
receiving process for message selection (see msgrcv 
below). Mtezt is any text of length msgsz bytes. Msgsz 
can range from 0 to a system-imposed maximum. 


Msgflg specifies the action to be taken if one or more of 
the following are true: 


The number of bytes already on the queue is 
equal to msg_qbytes (see intro(2)). 


The total number of messages on all queues 
system-wide is equal to the system-imposed 
limit. 

These actions are as follows: 
If (msgflg & IPC_NOWAIT) is “‘true”, the 
message will not be sent and the calling process 
will return immediately. 


If (msgflg & IPC_NOWAIT) is ‘“‘false”, the 
calling process will suspend execution until one 
of the following occurs: 
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The condition responsible for the 
suspension no longer exists, in which 
case the message is sent. 


Msgqid is removed from the system (see 
mare): When this occurs, errno is 
set equal to EIDRM, and a value of —1 
is returned. 


The calling process receives a signal 
that is to be caught. In this case the 
message is not sent and the calling 
process resumes execution in the 
manner prescribed in stgnal(2)). 


Msgsnd will fail and no message will be sent if one or 
more of the following are true: 


EINVAL} Msgqtd is not a valid message queue 
identifier. 

EACCES] Operation permission is denied to the 
calling process (see tntro(2)). 

EINVAL] Mtype is less than 1. 

EAGAIN] The message cannot be sent for one of 


the reasons cited above and (magflg & 
IPC_NOWAIT) is “true”’. 


EINVAL] Megsz is less than zero or greater than 
the system-imposed limit. 
EFAULT] Msgp points to an illegal address. 


Upon successful completion, the following actions are 
taken with respect to the data structure associated with 
msqid (see intro (2)). 

Msg_qnum is incremented by 1. 


Msg_Ispid is set equal to the process ID of the 
calling process. 


Msg_stime is set equal to the current time. 


Msgrcv reads a message from the queue associated with 
the message queue identifier specified by msgtd and 
places it in the structure pointed to by msgp. {READ} 
This structure is composed of the following members: 


long mtype; /* message type */ 
char mtext/]; /* message text */ 


Mtype is the received message’s type as specified by the 
sending process. Mtezt is the text of the message. Msgsz 
specifies the size in bytes of mtezt. The received 
message is truncated to msgsz bytes if it is larger than 
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msgsz and (msgflg & MSG_NOERROR) is “true”. The 
truncated part of the message is lost and no indication of 
the truncation is given to the calling process. 


Msgtyp specifies the type of message requested as follows: 


If msgtyp is equal to 0, the first message on the 
queue is received. 


If msgtyp is greater than 0, the first message of 
type msgtyp is received. 


If msgtyp is less than 0, the first message of the 
lowest type that is less than or equal to the 
absolute value of msgtyp is received. 


Msgflg specifies the action to be taken if a message of the 
desired type is not on the queue. These are as follows: 


If (msgflg & IPC_LNOWAIT) is “true”, the 
calling process will return immediately with a 
return value of —1 and errno set to ENOMSG. 


If (msgflg & IPC_LNOWAIT) is “false”, the 
calling process will suspend execution until one 
of the following occurs: 


A message of the desired type is placed 
on the queue. 


Msqid is removed from the system. 
When this occurs, errno is set equal to 
EIDRM, and a value of —1 is returned. 


The calling process receives a signal 
that is to be caught. In this case a 
message is not received and the calling 
process resumes execution in_ the 
manner prescribed in signal(2)). 


Msgrcv will fail and no message will be received if one or 
more of the following are true: 


EINVAL] Msqtd is not a valid message queue 
identifier. 

EACCES] Operation permission is denied to the 
calling process. 

EINVAL] Msgsz is less than 0. 

E2BIG] Mtext is greater than msgsz and (msgflg 


& MSG_NOERROR) is “‘false’’. 


ENOMSG] The queue does not contain a message 


of the desired type and (msgtyp & 
IPC_NOWAIT) is “true’’. 
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[EFAULT] Megp points to an illegal address. 


Upon successful completion, the following actions are 
taken with respect to the data structure associated with 
msqtd (see intro (2)). 

Msg_qnum is decremented by 1. 


Msg_Irpid is set equal to the process ID of the 
calling process. 


Msg_rtime is set equal to the current time. 


RETURN VALUES 
If msgsnd or msgrev return due to the receipt of a signal, 
a value of —1 is returned to the calling process and errno 
is set to EINTR. If they return due to removal of msqid 
from the system, a value of —1 is returned and errno is 
set to EIDRM. 


Upon successful completion, the return value is as 
follows: 


Msgsnd returns a value of 0. 


Msgrcv returns a value equal to the number of 
bytes actually placed into mtezt. 


Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
intro(2), msgctl(2), msgget(2), signal(2). 
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NAME 


NICE(2) 


nice — change priority of a process 


SYNOPSIS 


int nice (incr) 
int incr; 


DESCRIPTION 


Nice adds the value of tncr to the nice value of the 
calling process. A process’s nice value is a positive 
number for which a more positive value results in lower 
CPU priority. 


The system allows nice values only from —8 to 39. The 
nice system call grants nice values from —8 to —1 only to 
super-user processes. These negative nice values cause 
the CPU priority of the process to be fixed 
independently of CPU usage of the process. Nice values 
from 0 to 39 allow the system to adjust dynamically the 
actual CPU priority of the process, temporarily lowering 
it in proportion to the process’s recent level of CPU 
usage. If a super-user process requests a nice value 
below —8, or if any other process requests a nice value 
below 0, the system imposes a nice value of 0. If any 
process requests a nice value above 39, the system 
imposes a nice value of 39. 
[EPERM| Nice will fail and not change the nice 
value if incr is negative or greater than 
40 and the effective user ID of the 
calling process is not super-user. 


RETURN VALUE 


Upon successful completion, nice returns the new nice 
value minus 20. Otherwise, a value of —1 is returned 
and errno is set to indicate the error. 


SEE ALSO 


nice(1), exec(2). 


NAME 
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OPEN (2) 


open — open for reading or writing 
SYNOPSIS 


#include <fentl.h> 
int open (path; oflag { , mode | ) 
5 


char *pat 


int oflag, mode; 


DESCRIPTION 
Path points to a path name naming a file. Open opens a 
file descriptor for the named file and sets the file status 
flags according to the value of oflag. Oflag values are 
constructed by OR-ing flags from the following list (only 
one of the first three flags below may be used): 


O.RDONLY Open for reading only. 


O_WRONLY 


O_RDWR 
O_NDELAY 


Open for writing only. 
Open for reading and writing. 


This flag may affect subsequent reads and 
writes. See read(2) and write (2). 


When opening a FIFO with O_RDONLY or 
O_WRONLY set: 


If O_NDELAY is set: 


An open for reading-only will 
return without delay. An open 
for writing-only will return an 
error if no process currently has 
the file open for reading. 


If O_NDELAY is clear: 


An open for reading-only will 
block until a process opens the file 
for writing. An open for writing- 
only will block until a process 
opens the file for reading. 


When opening a file associated with a 
communication line: 


If O_NDELAY is set: 


The open will return without 
waiting for carrier. 


If O_NDELAY is clear: 


The open will block until carrier is 
present. 


“——~ 
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O_APPEND If set, the file pointer will be set to the 


O_DIRECT 


end of the file prior to each write. 


If set, subsequent reads or writes that 
satisfy the following criteria will be moved 
directly to or from the user space to the 
physical media: 


The transfer must start on a 1K 
byte boundary in the file, and it 
must be in multiples of 1K byte 
blocks. 


This option applies only to regular files. 
Note that direct implies synchronous. 


O_NODIRECT 


O_SYNC 


O_CREAT 


O_TRUNC 


O_EXCL 


Do not perform direct I/O for this file, 
even if a transfer satisfies the system 
default criteria. 


If set, all writes will be synchronous. This 
option applies only to regular files. 


If the file exists, this flag has no effect. 
Otherwise, the owner ID of the file is set 
to the effective user ID of the process, the 
group ID of the file is set to the effective 
group ID of the process, and the low-order 
10 bits of the file mode are set to the 
value of mode modified as follows (see 
creat(2)): 

All bits set in the file mode 

creation mask of the process are 

cleared. See umask(2). 

The ‘‘save text image after 


execution bit”? of the mode is 
cleared. See chmod(2). 


If the file exists, its length is truncated to 
0 and the mode and owner are unchanged. 


If O_EXCL and O_CREAT are set, open 
will fail if the file exists. 


The file pointer used to mark the current position within 
the file is set to the beginning of the file. 


The new file descriptor is set to remain open across ezec 
system calls. See fentl(2). 


The named file is opened unless one or more of the 
following are true: 


[ENOTDIR] 
[ENOENT] 
[EACCES] 
[EACCES] 
[EISDIR] 


[EROFS| 


[EMFILE} 


(ENXIO] 


[ETXTBSY] 


[EFAULT| 
{EEXIST] 


ENXIO] 


EINTR] 


ENFILE 
EDEADLOCK] 


RETURN VALUE 
Upon successful completion, the file descriptor is 
returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
cameos?) close(2), rer dup(2), fentl(2), locking(2), 
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A component of the path prefix is not a 
directory. 


O_CREAT is not set and the named file 
does not exist. 


A component of the path prefix denies 
search permission. 


Oflag permission is denied for the 
named file. 


The named file is a directory and oflag 
is write or read/write. 


The named file resides on a read-only 
file system and oflag is write or 
read/write. 


Twenty (20) file descriptors are 
currently open. 


The named file is a character special or 
block special file, and the device 
associated with this special file does not 
exist. 


The file is a pure procedure (shared 
text) file that is being executed and 
oflag is write or read/write. 


Path points outside the allocated 
address space of the process. 


O_CREAT and O_EXCL are set, and the 
named file exists. 


O_NDELAY is set, the named file is a 
FIFO, O_WRONLY is set, and no process 
has the file open for reading. 


A signal was caught during the open 
system call. 


The system file table is full. 


A side effect of a previous locking(2) 
call, when applying O_TRUNC . 


, read(2), umask(2), write(2). 


OPENI(2) 


NAME 
openi — open a file specified by i-node 
SYNOPSIS 


#include <sys/types.h> 
#include <fentl.h> 


int openi (dev, inode, oflag) 
dev_t dev; 

ino_t inode; 

int oflag; 


DESCRIPTION 
Opent permits access to a file without reference to any 
of its directory links. Because it doesn’t use the 
directory hierarchy, opent doesn’t require any access 
permission except from the file itself. Use of opent must 
be authorized in advance by syslocal(2). 


Dev specifies the device number of the file system that 
contains the file. Jnode is the i-number of the file. 
Oflag is a set of open flags, identical to those used with 
open(2). The return value is a file descriptor, like that 
returned by open. 


A file descriptor returned by opent has the same 
properties as one returned by open. It counts against 
the per-process limit of 20 file descriptors. 


The specified file is opened unless one or more of the 
following are true: 


The specified inode is not allocated. [ENOENT] 


Ofiag permission is denied for the named file. 
[EACCES] 


The named file is a directory. [EISDIR] 


The named file resides on a read-only file system 
and oflag is write or read/write. [EROFS] 


Twenty (20) file descriptors are currently open. 
[EMFILE] 


The named file is a character special or block 
special file. [ENXIO] 


The file is a pure procedure (shared text) file 
that is being executed and oflag is write or 
read/write. [ETXTBSY] 


Path points outside the process’s allocated 
address space. [EFAULT] 


O_CREAT and O_EXCL are set, and the named 
file exists. [EEXIST] 


a bee 
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O_NDELAY is set, the file is a FIFO, O_.WRONLY 
is set, and no process has the file open for 
reading. [ENXIO] 
The specified file system is not mounted. 
[ENXIO} 
RETURN VALUE 
On success, returns a file descriptor, a nonnegative 
integer. On failure, returns —1 and sets errno. 


SEE ALSO 
creat(2), open(2), syslocal(2). 
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NAME 

pause — suspend process until signal 
SYNOPSIS 

pause () 
DESCRIPTION 


Pause suspends the calling process until it receives a 
signal. The signal must be one that is not currently set 
to be ignored by the calling process. 


If the signal causes termination of the calling process, 
pause will not return. 


If the signal is caught by the calling process and control 
is returned from the signal-catching function (see 
signal(2)), the calling process resumes execution from the 
point of suspension; with a return value of —1 from 
pause and errno set to EINTR. 

SEE ALSO 
alarm(2), kill(2), signal(2), wait(2). 


PIPE(2) 


NAME 
pipe — create an interprocess channel 

SYNOPSIS 
int pipe (fildes) 
int fildes[2]; 

DESCRIPTION 
Pipe creates an I/O mechanism called Ai e and ae 
two file descriptors, fildes ° and fildes if Fildes [0 
opened for reading and fildes We is opened for cere 


Up to 9K bytes of data are buffered by the pipe before 
the writing process is blocked. A read only file 
descriptor fildes[0|] accesses the data written to fildes(I1| 
on a first-in-first-out (FIFO) basis. 


[EMFILE] Pipe will fail if 19 or more file 
descriptors are currently open. 
[ENFILE} The system file table is full. 
RETURN VALUE 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 
sh(1), read(2), write(2). 
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NAME 


PLOCK(2) 


plock — lock process, text, or data in memory 


SYNOPSIS 


#include <sys/lock.h> 


int plock (op) 
int op; 


DESCRIPTION 


Plock allows the calling process to lock its text segment 
(text lock), its data and stack segments (data lock), or 
both its text and data segments (process lock) into 
memory. Locked segments are immune to all routine 
swapping. Plock also allows these segments to be 
unlocked. For 407 object modules TXTLOCK and 
DATLOCK are identical. The effective user ID of the 
calling process must be super-user to use this call. Op 
specifies the following: 


PROCLOCK lock text and data segments into 
memory (process lock) 


TXTLOCK lock text segment into memory (text 


lock) 

DATLOCK lock data segment into memory (data 
lock) 

UNLOCK remove locks 


Shared regions (e.g., text) may be locked by anyone 
using the text, but they may be unlocked only if the 
caller is the last one using the region. Note that sticky- 
bit text that is not explicitly unlocked will remain locked 
in core even after the last process using it terminates. 


Plock will fail and not perform the requested operation if 
one or more of the following are true: 


{[EPERM] The effective user ID of the calling 
process is not super-user. 
[EINVAL] Op is equal to PROCLOCK and a 


process lock, a text lock, or a data lock 
already exists on the calling process. 


[EINVAL] Op is equal to TXTLOCK and a text 
lock, or a process lock already exists on 
the calling process. 


[EINVAL] Op is equal to DATLOCK and a data 
lock, or a process lock already exists on 
the calling process. 


[EINVAL] Op is equal to UNLOCK and no type of 
lock exists on the calling process. 


me 
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RETURN VALUE 
Upon successful completion, a value of 0 is returned to 
the calling process. Otherwise, a value of —1 is returned 
and errno is set to indicate the error. 


SEE ALSO 
exec(2), exit(2), fork(2). 


NAME 


PROFIL (2) 


profil — execution time profile 


SYNOPSIS 


void profil (buff, bufsiz, offset, scale) 
char *buff; 
int bufsiz, offset, scale; 


DESCRIPTION 


Buff points to an area of core whose length (in bytes) is 
given by bufstz. After this call, the user’s program 
counter (pc) is examined each clock tick (60th second); 
offset is subtracted from it, and the result multiplied by 
scale. If the resulting number corresponds to a word 
inside buff, that word is incremented. 


The scale is interpreted as an unsigned, fixed-point 
fraction with binary point at the left: 0177777 (octal) 
ives a 1-1 mapping of pc’s to words in buff; 077777 
(octal) maps each pair of instruction words together. 
02(octal) maps all instructions onto the beginning of buff 
(producing a non-interrupting core clock). 


Profiling is turned off by giving a scale of 0 or 1. It is 
rendered ineffective by giving a bufstz of 0. Profiling is 
turned off when an ezec is executed, but remains on in 
child and parent both after a fork. Profiling will be 
Hae off if an update in buff would cause a memory 
fault. 


RETURN VALUE 


Not defined. 


SEE ALSO 


prof(1), monitor(3C). 


PTRACE( 2) 


NAME 
ptrace — process trace 


SYNOPSIS 
int ptrace (request, pid, addr, data); 
int request, pid, addr, data; 


DESCRIPTION 

Ptrace provides a means by which a parent process may 
control the execution of a child process. Its primary use 
is for the implementation of breakpoint debugging; see 
sdb(1). The child process behaves normally until it 
encounters a signal (see stgnal(2) for the list), at which 
time it enters a stopped state and its parent is notified 
via wait(2). When the child is in the stopped state, its 
parent can examine and modify its ‘‘core image”’ using 
ptrace. Also, the parent can cause the child either to 
terminate or continue, with the possibility of ignoring 
the signal that caused it to stop. 


The request argument determines the precise action to 
be taken by ptrace and is one of the following: 


0 This request must be issued by the child process if 
it is to be traced by its parent. It turns on the 
child’s trace flag that stipulates that the child 
should be left in a stopped state upon receipt of a 
signal rather than the state specified by func; see 
stgnal(2). The ptd, addr, and data arguments are 
ignored, and a return value is not defined for this 
request. Peculiar results will ensue if the parent 
does not expect to trace the child. 


The remainder of the requests can only be used by the 
parent process. For each, ptd is the process ID of the 
child. The child must be in a stopped state before these 
requests are made. 


1,2 With these requests, the word at location addr in 
the address space of the child is returned to the 
parent process. If I and D space are separated (as 
on PDP-11s), request 1 returns a word from I space, 
and request 2 returns a word from D space. If I 
and D space are not separated (as on Convergent 
Technologies 68000-family processors), either 
request 1 or request 2 may be used with equal 
results. The data argument is ignored. These two 
requests will fail if addr is not the start address of 
a word, in which case a value of —1 is returned to 
the parent process and the parent’s errno is set to - 
EIO. 
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With this request, the word at location addr in the 
child’s USER area in the system’s address space (see 
<sys/user.h>) is returned to the parent process. 
Addresses in this area range from 0 to USIZE on 
Convergent Technologies 68000-family processors. 
The data argument is ignored. This request will 
fail if addr is not the start address of a word or is 
outside the USER area, in which case a value of —1 
is returned to the parent process and the parent’s 
errno is set to ElO. 


With these requests, the value given by the data 
argument is written into the address space of the 
child at location addr. If I and D space are 
separated (as on PDP-lls), request 4 writes a word 
into I space, and request 5 writes a word into D 
space. If I and D space are not separated (as on 
Convergent Technologies 68000-family processors), 
either request 4 or request 5 may be used with 
equal results. Upon successful completion, the 
value written into the address space of the child is 
returned to the parent. These two requests will fail 
if addr is a location in a pure procedure space and 
another process is executing in that space, or addr 
is not the start address of a word. Upon failure a 
value of —1 is returned to the parent process and 
the parent’s errno is set to EIO. 


With this request, a few entries in the child’s USER 
area can be written. Data gives the value that is 
to be written and addr is the location of the entry. 
The few entries that can be written are: 


the general registers (i.e., registers 0 to 15 
on Convergent Technologies 68000-family 
processors). 


all processor status bits except 8, 9, 10, 12, 
and 13. 


This request causes the child to resume execution. 
If the data argument is 0, all pending signals 
including the one that caused the child to stop are 
canceled before it resumes execution. If the data 
argument is a valid signal number, the child 
resumes execution as if it had incurred that signal, 
and any other pending signals are canceled. The 
addr argument must be equal to 1 for this request. 
Upon successful completion, the value of data is 
returned to the parent. This request will fail if 
data is not O or a valid signal number, in which 
case a value of —1 is returned to the parent process 


' 
ro 
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and the parent’s errno is set to EIO. 


8 This request causes the child to terminate with the 
same consequences as ezit(2). 


9 This request sets the trace bit in the Processor 
Status Word of the child (ie. bit 15 on 
Convergent Technologies 68000-family processors) 
and then executes the same steps as listed above 
for request 7. The trace bit causes an interrupt 
upon completion of one machine instruction. This 
effectively allows single stepping of the child. 

To forestall possible fraud, ptrace inhibits the set-user-id 

facility on subsequent ezec(2) calls. If a traced process 

calls exec, it will stop before executing the first 

instruction of the new image showing signal SIGTRAP. 
GENERAL ERRORS 

Ptrace will in general fail if one or more of the following 


are true: 

{EIO} Request is an illegal number. 

[ESRCH] Pid identifies a child that does not exist 
or has not executed a ptrace with 
request 0. 


FILES 
/usr/include/sys/page.h 
/usr/include/sys/user.h 
SEE ALSO 
exec(2), signal(2), wait(2). 
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NAME 


READ (2) 


read — read from file 


SYNOPSIS 


int read (fildes, buf, nbyte) 
int fildes; 

char *buf; 

unsigned nbyte; 


DESCRIPTION 


Fildes is a file descriptor obtained from a creat, open, 
dup, fentl, or pipe system call. 


Read attempts to read nbyte bytes from the file 
associated with fildes into the buffer pointed to by buf. 


On devices capable of seeking, the read starts at a 
position in the file given by the file pointer associated 
with fildes. Upon return from read, the file pointer is 
incremented by the number of bytes actually read. 


Devices that are incapable of seeking always read from 
the current position. The value of a file pointer 
associated with such a file is undefined. 


Upon successful completion, read returns the number of 
bytes actually read and placed in the buffer; this number 
may be less than nbyte if the file is associated with a 
communication line (see tocti(2) and termio(7)), or if the 
number of bytes left in the file is less than nbyte bytes. 
A value of 0 is returned when an end-of-file has been 
reached. 


When attempting to read from an empty pipe (or FIFO): 
If O_NDELAY is set, the read will return a 0. 


If OLNDELAY is clear, the read will block until 
data is written to the file or the file is no longer 
open for writing. 


When attempting to read a file associated with a tty 
that has no data currently available: 


If O_LNDELAY is set, the read will return a 0. 


If O_NDELAY is clear, the read will block until 
data becomes available. 


Read will fail if one or more of the following are true: 


|EBADF} Fildes is not a valid file descriptor open 
for reading. 

|EFAULT] Buf points outside the allocated address 
space. 


READ(2) 


[EINTR] A signal was caught during the read 
system call. 


{(EDEADLOCK| A side effect of a previous locking(2) 
call. 

RETURN VALUE 
Upon successful completion a non-negative integer is 
returned indicating the number of bytes actually read. 
Otherwise, a —1 is returned and errno is set to indicate 
the error. 

SEE ALSO 


creat(2), dup(2), fentl(2), ioctl(2), locking(2), open(2), 
pipe(2), termio(7). 


-_~ 


RECV(2N) 


recv, recvfrom — receive a message from a socket 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/socket.h> 


recv(s, buf, len, flags) 
int 3; 

char *buf; 

int len, flags; 


recvfrom(s, buf, len, flags, from, fromlen) 
int 38; 

char “buf; 

int len, flags; 

struct sockaddr *from; 

int *fromlen; 


DESCRIPTION 


Recv and recvfrom are used to receive messages from a 
socket. 


The recv call may be used only on a connected socket 
(see connect(2)), while recvfrom may be used to receive 
data on a socket whether it is in a connected state or 
not. 


If from is non-zero, the source address of the message is 
filled in. Fromlen is a value-result parameter, initialized 
to the size of the buffer associated with from, and 
modified on return to indicate the actual size of the 
address stored there. The length of the message is 
returned in cc. If a message is too long to fit in the 
supplied buffer, excess bytes may be discarded depending 
on the type of socket the message is received from; see 
socket(2). 


If no messages are available at the socket, the receive 
call waits for a message to arrive. 


The flags argument to a send call is formed by or’ing 
one or more of the values: 


#define MSG_PEEK  Ox1 

/* peek at incoming message */ 
#define MSG_OOB 0x2 

/* process out-of-band data */ 


.~ RETURN VALUE 


These calls return the number of bytes received, or —1 if 
an error occurred. 


ERRORS 


The calls fail if: 


(EBADF] 


(ENOTSOCK] 
[EINTR) 


[EFAULT] 


SEE ALSO 


RECV(2N) 


The argument ¢ is an invalid 
descriptor. 


The argument s is not a socket. 


The receive was interrupted by 
delivery of a signal before any 
data was available for the receive. 


The data was specified to be 
received into a non-existent or 
protected part of the process 
address space. 


connect(2N), read(2), send(2), socket(2N). 
CTIX Internetworking Manual. 


NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
semctl — semaphore control operations 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipe.h> 
#include <sys/sem.h> 


int semctl (semid, semnum, cmd, arg) 
int semid, cmd; 
int semnum; 
union semun { 
int val; 
struct semid_ds *buf; 
ushort *array; 
} arg; 
DESCRIPTION 
Semctl provides a variety of semaphore control 
operations as specified by emd. 
The following cmds are executed with respect to the 
semaphore specified by semtd and semnum: 
GETVAL Return the value of semval (see intro(2)). 
{READ} 
SETVAL Set the value of semval to arg.val. 
{ALTER} When this cmd is successfully 
executed, the semadj value corresponding 


to the specified semaphore in all processes 
is cleared. 


GETPID Return the value of sempid. {READ} 

GETNCNT Return the value of semnent. {READ} 

GETZCNT Return the value of semzcnt. {READ} 

The following cmds return and set, respectively, every 

semval in the set of semaphores. 

GETALL Place semvals into array pointed to by 
arg.array. {READ} 


SETALL Set semvals according to the array 
pointed to by erg.array. {ALTER} When 
this cmd is successfully executed the 
semadj values corresponding to each 
specified semaphore in all processes are 
cleared. 


The following emds are also available: 


IPC_STAT Place the current value of each member 
of the data structure associated with 
semid into the structure pointed to by 


Pa ee 


IPC_SET 
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arg.buf. The contents of this structure 
are defined in tntro(2). {READ} 


Set the value of the following members of 
the data structure associated with semid 
to the corresponding value found in the 
structure pointed to by arg.buf: 
sem_perm.uid 

sem_perm.gid 

sem_perm.mode /* only low 9 bits +*/ 


This cmd can only be executed 
by a process that has an effective 
user ID equal to either that of 
super-user or to the value of 
sem_perm.uid in the data 
structure associated with semid. 


IPC_RMID Remove the semaphore 
identifier specified by 
semid from the system and 
destroy the set of 
semaphores and data 
structure associated with 
it. This cmd can only be 
executed by a process that 
has an effective user ID 
equal to either that of 
super-user or to the value 
of sem_perm.uid in the 
data structure associated 
with semid. 


Semcetl will fail if one or more of the 
following are true: 


EINVAL] Semtd is not a _ valid 
semaphore identifier. 

EINVAL] Semnum is less than zero 
or greater than 
sem_nsems. 

EINVAL] Cmd is not a_ valid 
command. 

EACCES] Operation permission is 
denied to the calling 
process (see tntro(2)). 

ERANGE] Cmd is SETVAL or 


SETALL and the value 
to which semval is to be 
set is greater than the 
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system imposed 
maximum. 
[EPERM] Cmd is equal __to 


IPC_RMID or IPC_SET 
and the effective user ID 
of the calling process is 
not equal to that of 
super-user and it is not 
equal to the value of 
sem_perm.uid in the 
data structure associated 
with semid. 


{|EFAULT] Arg.buf points to an 
illegal address. 
RETURN VALUE 


Upon successful completion, the value returned depends 
on cmd as follows: 


GETVAL The value of semval. 
GETPID The value of sempid. 
GETNOCNT The value of semncnt. 
GETZCNT The value of semzcnt. 
All others A value of 0. 


Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

SEE ALSO 
intro(2), semget(2), semop(2). 


SEMGET (2) 


semget — get set of semaphores 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sem.h> 


int semget (key, nsems, semflg) 
key_t key; 
int nsems, semflg; 


DESCRIPTION 


Semget returns the semaphore identifier associated with 
key. 


A semaphore identifier and associated data structure and 
set containing nsems semaphores (see tntro({2)) are 
created for key if one of the following are true: 


Key is equal to IPC_PRIVATE. 


Key does not already have a semaphore 
identifier associated with it, and (semflg & 
IPC_CREAT) is “‘true”’. 


Upon creation, the data structure associated with the 
new semaphore identifier is initialized as follows: 


Sem_perm.cuid, sem_perm.uid, 
sem_perm.cgid, and sem_perm.gid are set 
equal to the effective user ID and effective group 
ID, respectively, of the calling process. 


The low-order 9 bits of sem_perm.mode are 
set equal to the low-order 9 bits of sem/flg. 


Sem_nsems is set equal to the value of nsems. 


Sem_otime is set equal to 0 and sem_ctime is 
set equal to the current time. 


Semget will fail if one or more of the following are true: 


[EINVAL] Neems is either less than or equal to 
zero or greater than the system-imposed 
limit. 

[EACCES] A semaphore identifier exists for key, 


but operation permission (see tntro(2)) 
as specified by the low-order 9 bits of 
semflg would not be granted. 


[EINVAL] A semaphore identifier exists for key, 
but the number of semaphores in the 
set associated with it is less than nsems 
and nsems is not equal to zero. 
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[ENOENT] A semaphore identifier does not exist 
for key and (semflg & IPC_CREAT) is 
“false”’. 

[ENOSPC] A semaphore identifier is to be created 


but the system-imposed limit on the 
maximum number of allowed semaphore 
identifiers system wide would’ be 
exceeded. 


[ENOSPC} A semaphore identifier is to be created 
but the system-imposed limit on the 
maximum number of allowed 
semaphores system wide would be 
exceeded. 


[EEXIST] A semaphore identifier exists for key 
but Leemfty & IPC_CREAT) and 
(semflg & IPC_EXCL) ) is “‘true”’. 


RETURN VALUE 
Upon successful completion, a non-negative integer, 
namely a semaphore identifier, is returned. Otherwise, a 
value of -1 is returned and errno is set to indicate the 
error. 


SEE ALSO 
— 


intro(2), semctl(2), semop(2). 


NAME 


SEMOP (2) 


semop — semaphore operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sem.h> 


int semop (semid, sops, nsops) 
int semid; 

struct sembuf **sops; 

int nsops; 


DESCRIPTION 


Semop is used to atomically perform an array of 
semaphore operations on the set of semaphores 
associated with the semaphore identifier specified by 
semid. Sops is a pointer to the array of semaphore- 
operation structures. Nsops is the number of such 
structures in the array. The contents of each structure 
includes the following members: 


short sem_num; /* semaphore number */ 
short | sem_op; /* semaphore operation */ 
short sem_flg; /* operation flags */ 


Each semaphore operation specified by sem_op is 
performed on the corresponding semaphore specified by 
semid and sem_num. 


Sem_op specifies one of three semaphore operations as 
follows: 


If sem_op is a negative integer, one of the 
following will occur: {ALTER} 


If semval (see tnéro(2)) is greater than 
or equal to the absolute value of 
sem_op, the absolute value of sem_op 
is subtracted from semval. Also, if 
(sem_flg & SEM_UNDO) is “‘true’’, the 
absolute value of sem_op is added to 
the calling process’s semadj value (see 
extt(2)) for the specified semaphore. 
All processes suspended waiting for 
semval are rescheduled. 


If semval is less than the absolute value 
of 8em_op and (sem_flg & 
IPC_NOWAIT) is “true”, semop will 
return immediately. 


If semval is less than the absolute value 
of sem_op and (sem_flg & 
IPC_NOWAIT) is “false”, semop will 
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increment the semncnt associated with 
the specified semaphore and suspend 
execution of the calling process until 
one of the following conditions occurs: 


Semval becomes greater than or 
equal to the absolute value of 
sem_op. When this occurs, the 
value of semncnt associated with the 
specified semaphore is decremented, 
the absolute value of sem_op is 
subtracted from semval and, if 
(sem_flg & SEM_UNDO) is “‘true’’, 
the absolute value of sem_op is 
added to the calling process’s semadj 
value for the specified semaphore, 
and all the operations are tried 
again. 

The semid for which the calling 
process is awaiting action is removed 
from the system (see semctl(2)). 
When this occurs, errno is set equal 
to EIDRM, and a value of -1 is 
returned. 


The calling process receives a signal 
that is to be caught. When this 
occurs, the value of semnent 
associated with the — specified 
semaphore is decremented, and the 
calling process resumes execution in 
the manner prescribed in stgnal(2). 
If sem_op is a positive integer, the value of 
sem_op is added to semval and, if (sem_fig & 
SEM_UNDO) is “‘true’’, the value of sem_op is 
subtracted from the calling process’s semadj 
value for the specified semaphore. {ALTER} 


If sem_op is zero, one of the following will 
occur: {READ} 
If semval is zero, semop will return 
immediately. 


If semval is not equal to zero and 
(sem_flg & IPC_NOWAIT) is ‘“‘true’’, 
semop will return immediately. 


If semval is not equal to zero and 
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(sem_flg & IPC_NOWAIT) is “‘false’’, 
semop will increment the semzcnt 
associated with the specified semaphore 
and suspend execution of the calling 
process until one of the following 
occurs: 


Semval becomes zero, at which time 
the value of semzcnt associated with 
the specified semaphore is 
decremented. 


The semid for which the calling 
process is awaiting action is removed 
from the system. When this occurs, 
errno is set equal to EIDRM, and a 
value of —1 is returned. 


The calling process receives a signal 
that is to be caught. When this 
occurs, the value of semzcnt 
associated with the — specified 
semaphore is decremented, and the 
calling process resumes execution in 
the manner prescribed in stgnal(2). 


Semop will fail if one or more of the following are true 
for any of the semaphore operations specified by sops: 


[EINVAL] 


[EFBIG| 


E2BIG] 
EACCES| 


EAGAIN] 


ENOSPC|] 


EINVAL] 


Semtd is not a valid semaphore 
identifier. 


Sem_num is less than zero or greater 
than or equal to the number of 
semaphores in the set associated with 
semtd. 


Nsops is greater than the system- 
imposed maximum. 


Operation permission is denied to the 
calling process (see intro(2)). 


The operation would” result in 
suspension of the calling process but 
(sem_flg & IPC_NOWAIT) is “‘true”’. 


The limit on the number of individual 
processes requesting an SEM_UNDO 
would be exceeded. 


The number of individual semaphores 
for which the calling process requests a 
SEM_UNDO would exceed the limit. 
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[ERANGE] An operation would cause a semval to 
overflow the system-imposed limit. 

[ERANGE] An operation would cause a semadj 
value to overflow the system-imposed 
limit. 

[EFAULT] Sops points to an illegal address. 


Upon successful completion, the value of sempid for each 
semaphore specified in the array pointed to by sops is set 
equal to the process ID of the calling process. 


RETURN VALUE 
If semop returns due to the receipt of a signal, a value of 
—1 is returned to the calling process and errno is set to 
EINTR. If it returns due to the removal of a semid from 
the system, a value of —1 is returned and errno is set to 
EIDRM. 


Upon successful completion, the value of semval at the 
time of the call for the last operation in the array 
pointed to by sops is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 


SEE ALSO 
exec(2), exit(2), fork(2), intro(2), semctl(2), semget(2). 


SEND (2N) 


NAME 
send, sendto — send a message to a socket 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 
send(s, msg, len, flags) 
int 3; 
char *msg; 
int len, flags; 
sendto(s, msg, len, flags, to, tolen) 
int 8; 
char *msg; 
int len, flags; 
struct sockaddr *to; 
int tolen; 


DESCRIPTION 
Send and sendto are used to transmit a message to 
another socket (s). Send may be used only when the 
socket is in a connected state, while sendto may be used 
at any time. 


The address of the target is given by to with tolen 
specifying its size. The length of the message is given by 
len. If the message is too long to pass atomically 
through the underlying protocol, then the error 
EMSGSIZE is returned, and the message is not 
transmitted. 


No indication of failure to deliver is implicit in a send. 
Return values of -1 indicate some locally detected 
errors. 


If no message space is available at the socket to hold the 
message to be transmitted, then send blocks. 


The flags parameter may be set to SOF_OOB to send 
out-of-band data on sockets which support this notion 
(e.g., SOCK_STREAM). 

RETURN VALUE 


The call returns the number of characters sent, or —1 if 
an error occurred. 


ERRORS 
[(EBADF] An invalid descriptor = was 
specified. 
[ENOTSOCK|] The argument s is not a socket. 
[EFAULT] An invalid user space address was 


specified for a parameter. 


SEND (2N) 


[EMSGSIZE] The socket requires that message 
be sent atomically, and the size of 
the message to be sent made this 
impossible. 

SEE ALSO 

recv(2N), socket(2N). 

CTIX Internetworking Manual. 
NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 

setpgrp — set process group ID 
SYNOPSIS 

int setpgrp ( ) 
DESCRIPTION 


Setpgrp sets the process group ID of the calling process to 
the process ID of the calling process and returns the 
process group ID. 


RETURN VALUE 


Setpgrp returns the value of the process group ID. 


SEE ALSO 


NOTE 
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exec(2), fork(2), getpid(2), intro(2), kill(2), signal(2). 


This function is incorrectly documented in the UNIX 
System V_ Interface definition and other UNIX 
documentation. The description here accurately 
describes the system call. 


NAME 


SETUID (2) 


setuid, setgid — set user and group IDs 


SYNOPSIS 


int setuid (uid) 
int uid; 
int setgid (gid) 
int gid; 


DESCRIPTION 


Setuid (setgid) is used to set the real user (group) ID and 
effective user (group) ID of the calling process. 


If the effective user ID of the calling process is super- 
user, the real user (group) ID and effective user (group) 
ID are set to uid (gid). 


If the effective user ID of the calling process is not 
super-user, but its real user (group) ID is equal to wid 
(gid), the effective user (group) ID is set to utd (gid). 

If the effective user ID of the calling process is not 
super-user, but the saved set-user (group) ID from ezec(2) 
is equal to utd (gtd), the effective user (group) ID is set to 
wid (gid). 

Setuid (setgid) will fail if the real user (group) ID of the 
calling process is not equal to utd (gid) and its effective 
user ID is not super-user. [EPERM] 


The utd is out of range. [EINVAL] 


RETURN VALUE 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


getuid(2), intro(2). 
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NAME 
shmctl — shared memory control operations 


SYNOPSIS 
#Hinclude <sys/types.h> 
#include <sys/ipe.h> 
#tinclude <sys/shm.h> 


int shmctl (shmid, cmd, buf) 
int shmid, cmd; 
struct shmid_ds *buf; 


DESCRIPTION 
Shmetl provides a variety of shared memory control 
operations as specified by cmd. The following emds are 
available: 


IPC_STAT Place the current value of each member of 
the data structure associated with shmid 
into the structure pointed to by buf. The 
contents of this structure are defined in 
{EINVAL] tntro(2). {READ} 


IPC_SET Set the value of the following members of 
the data structure associated with shmid to 
the corresponding value found in the 
structure pointed to by buf: 
shm_perm.uid 
shm_perm.gid 
shm_perm.mode /* only low 9 bits */ 


This cmd can only be executed by a process 
that has an effective user ID equal to either 
that of super-user or to the value of 
shm_perm.uid in the data structure 
associated with shmid. 


SHM_LOCK Lock the shared memory segment 
specified by shmtd in memory. This 
emd can only be executed by a process 
that has an effective user ID equal to 
super user. 


SHM_UNLOCK 
Unlock the shared memory segment 
specified by shmtd. This emd can only 
be executed by a process that has an 
effective user ID equal to super user. 


IPC_RMID Remove the shared memory identifier 
specified by shmtd from the system and 
destroy the shared memory segment 
and data structure associated with it. 
This cmd can only be executed by a 
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process that has an effective user ID 
equal to either that of super-user or to 
the value of shm_perm.uid in the 
data structure associated with shmid. 


Shmetl will fail if one or more of the following are true: 


EINVAL] 


EINVAL] 
EACCES] 


EPERM] 


[EPERM] 


[EINVAL] 


(EFAULT] 
RETURN VALUE 


Shmid is not a valid shared memory 
identifier. 


Cmd is not a valid command. 


Cmd is equal to IPC_STAT and 
{READ} operation permission is denied 
to the calling process (see intro(2)). 


Cmd is equal to IPC_LRMID or 
IPC_SET and the effective user ID of 
the calling process is not equal to that 
of super user and it is not equal to the 
value of shm_perm.uid in the data 
structure associated with shmid. 

Cmd is equal to SHM_LOCK or 
SHM_UNLOCK and the effective user 
ID of the calling process is not equal to 
that of super user. 


Cmd is equal to SHM_UNLOCK and 
the shared-memory segment specified 
by shmid is not locked in memory. 


Buf points to an illegal address. 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


intro(2), shmget(2), shmop(2). 
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NAME 
shmget — get shared memory segment 
SYNOPSIS 
#tinclude <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shm.h> 
int shmget (key, size, shmflg) 
key_t key; 
int size, shmflg; 
DESCRIPTION 


Shmget returns the shared memory identifier associated 
with key. 


A shared memory identifier and associated data structure 
and shared memory segment of size stze bytes (see 
intro(2)) are created for key if one of the following are 
true: 


Key is equal to IPC_PRIVATE. 


Key does not already have a shared memory 
identifier associated with it, and (shmflg & 
IPC_CREAT) is “‘true’’. 

Upon creation, the data structure associated with the 

new shared memory identifier is initialized as follows: 
Shm_perm.cuid, shm_perm.uid, 
shm_perm.cgid, and shm_perm.gid are set 
equal to the effective user ID and effective group 
ID, respectively, of the calling process. 
The low-order 9 bits of shm_perm.mode are 
set equal to the low-order 9 bits of shmflg. 
Shm_segsz is set equal to the value of size. 
Shm_Ipid, shm_nattch, shm_atime, and 
shm_dtime are set equal to 0. 


Shm_ctime is set equal to the current time. 
Shmget will fail if one or more of the following are true: 


[EINVAL] Size is less than the system-imposed 
minimum or greater than the system- 
imposed maximum. 

[EACCES] A shared memory identifier exists for 
key but operation permission (see 
tntro(2)) as specified by the low-order 9 
bits of shmflg would not be granted. 

[EINVAL] A shared memory identifier exists for 


key but the size of the segment 
associated with it is less than size and 
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stze is not equal to zero. 


[ENOENT] A shared memory identifier does not 
exist for key and (shmflg & 

rane IPC_CREAT) is “false”. 
[ENOSPC] A shared memory identifier is to be 


created but the system-imposed limit on 
the maximum number of allowed shared 
memory identifiers system wide would 
be exceeded. 


[ENOMEM] A shared memory identifier and 
associated shared memory segment are 
to be created but the amount of 
available physical memory is_ not 
sufficient to fill the request. 


[EEXIST} A shared memory identifier exists for 
key but ( (shmflg & IPC_CREAT) and 
( shmflg & IPC_EXCL) ) is “‘true”’. 


RETURN VALUE 
Upon successful completion, a non-negative integer, 
namely a shared memory identifier is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
intro(2), shmctl(2), shmop(2). 
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NAME 
shmop — shared memory operations 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shm.h> 


char *shmat (shmid, shmaddr, shmflg) 
int shmid; 

char *shmaddr 

int shmfig; 


int shmdt (shmaddr) 
char *shmaddr 


DESCRIPTION 
Shmat attaches the shared memory segment associated 
with the shared memory identifier specified by shmid to 
the data segment of the calling process. The segment is 
attached at the address specified by one of the following 
criteria: 


If shmaddr is equal to zero, the segment is 
attached at the first available address as selected 
by the system. 


If shmaddr is not equal to zero and (shmflg & 
SHM_RND) is “‘true’’, the segment is attached 
at the address given by (shmaddr - (shmaddr 
modulus SHMLBA)). 


If shmaddr is not equal to zero and (shmflg & 
SHM_RND) is “‘false”, the segment is attached 
at the address given by shmaddr. 
The segment is attached for reading if (shmflg & 
SHM_RDONLY) is ‘‘true’” {READ}, otherwise it is 
attached for reading and writing {READ/WRITE}. 


Shmat will fail and not attach the shared memory 
segment if one or more of the following are true: 


EINVAL} Shmid is not a valid shared memory 
identifier. 

EACCES| Operation permission is denied to the 
calling process (see tntro(2)). 

ENOMEM} The available data space is not large 
enough to accommodate the shared 
memory segment. 

EINVAL] Shmaddr is not equal to zero, and the 


value of (shmaddr - (shmaddr modulus 
SHMLBA)) is an illegal address. 


SHMOP (2) 


[EINVAL Shmaddr is not equal to zero, (shmflg & 
SHM_RND) is “false”, and the value of 
shmaddr is an illegal address. 


{(EMFILE The number of shared memory 
segments attached to the calling process 
would exceed the system-imposed limit. 


[EINVAL Shmdt detaches from the calling 
process’s data segment the shared 
memory segment located at the address 
specified by shmaddr. 


[EINVAL] Shmdt will fail and not detach the 
shared memory segment if shmaddr is 
not the data segment start address of a 
shared memory segment. 


RETURN VALUES 
Upon successful completion, the return value is as 
follows: 


Shmat returns the data segment start address of 
the attached shared memory segment. 
Shmdt returns a value of 0. 


Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 
exec(2), exit(2), fork(2), intro(2), shmctl(2), shmget(2). 
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NAME 
shutdown — shut down part of a full-duplex connection 


SYNOPSIS 
shutdown(s, how) 
int s, how; 


DESCRIPTION 
The shutdown call causes all or part of a full-duplex 
connection on the socket associated with s to be shut 
down. If how is 0, then further receives will be 
disallowed. If how is 1, then further sends will be 
disallowed. If how is 2, then further sends and receives 


will be disallowed. 


DIAGNOSTICS 

A 0 is returned if the call succeeds, —1 if it fails. 
ERRORS 

The call succeeds unless: 

[EBADF| S is not a valid descriptor. 


[ENOTSOCK] Sis a file, not a socket. 
[ENOTCONN] The specified socket is not connected. 
SEE ALSO 


connect(2N), socket(2N). 
CTIX Internetworking Manual. 


NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 


SIGNAL (2) 


signal — specify what to do upon receipt of a signal 


SYNOPSIS 


#include <signal.h> 
int (*signal (sig, func))( ) 
int sig; 


void (*func)( ); 


DESCRIPTION 
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Stgnal allows the calling process to choose one of three 
ways in which it is possible to handle the receipt of a 
specific signal. Sig specifies the signal and fune specifies 
the choice. 


Sig can be assigned any one of the following except 
SIGKILL: 


SIGHUP ol hangup 

SIGINT 02 interrupt 

SIGQUIT 03* quit 

SIGILL 04* illegal instruction (not reset when 
caught) 


SIGTRAP  05* trace trap (not reset when caught) 
SIGIOT 06* IOT instruction 

SIGEMT 07* EMT instruction 

SIGFPE 08* floating point exception 


SIGKILL 09 kill (cannot be caught or ignored) 

SIGBUS 10* bus error 

SIGSEGV 11* segmentation violation 

SIGSYS 12* bad argument to system call 

SIGPIPE 13 write on a pipe with no one to 
read it 

SIGALRM 14 alarm clock 

SIGTERM 15 software termination signal 

SIGUSR1 16 user-defined signal 1 

SIGUSR2 17 user-defined signal 2 

SIGCLD 18 death of a child (see WARNING 
below) 

SIGPWR_ 19 power fail (see WARNING below) 


See SIG_DFL below for the significance of the asterisk 
*) in the above list.) 
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Fune is assigned one of three values: SIG_DFL, 
SIG_IGN, or a function address. The actions prescribed 
by these values are as follows: 


SIG_DFL - terminate process upon receipt of a 


signal 


Upon receipt of the signal sig, the receiving 
process is to be terminated with all of the 
consequences outlined in ezit(2). In addition, 
a “core image’ will be made in the current 
working directory of the receiving process if 
sig is one for which an asterisk (*) appears in 
the above list and the following conditions 
are met: 


The effective user ID and the real 
user ID of the receiving process are 
equal. 


An ordinary file named core exists 
and is writable or can be created. If 
the file must be created, it will have 
the following properties: 


a mode of 0666 modified by 
the file creation mask (see 
umask(2)) 


a file owner ID that is the 
same as the effective user 
ID of the receiving process 


a file group ID that is the 
same as the effective group 
ID of the receiving process 


SIG_IGN — ignore signal 


The signal stg is to be ignored. 
Note: the signal SIGKILL cannot be ignored. 


function address — catch signal 


Upon receipt of the signal sig, the receiving 
process is to execute the signal-catching 
function pointed to by fune. The signal 
number stg will be passed as the only argument 
to the signal-catching function. Before entering 
the signal-catching function, the value of func 
for the caught signal will be set to SIG_DFL 
unless the signal is SIGILL, SIGTRAP, or 
SIGPWR. 


Upon return from the signal-catching function, 
the receiving process will resume execution at 
the point it was interrupted. 
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When a signal that is to be caught occurs 
during a read, a write, an open, or an tocll 
system call on a slow device (like a terminal; 
but not a file), during a pause system call, or 
during a watt system call that does not return 
immediately due to the existence of a 
previously stopped or zombie process, the signal 
catching function will be executed and then the 
interrupted system call may return a —1 to the 
calling process with errno set to EINTR. 


Note: The signal SIGKILL cannot be caught. 


A call to stgnal cancels a pending signal stg except for a 
pending SIGKILL signal. 


Signal will fail if stg is an illegal signal number, 
including SIGKILL. [EINVAL] 


RETURN VALUE 


Upon successful completion, signal returns the previous 
value of fune for the specified signal stg. Otherwise, a 
value of —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 


kill(1), kill(2), pause(2), ptrace(2), wait(2), setjmp(3C). 


WARNING 
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Two other signals that behave differently than the 
signals described above exist in this release of the 
system; they are: 


SIGCLD 18 death of a child (reset when caught) 
SIGPWR_ 19 _ power fail (not reset when caught) 


There is no guarantee that, in future releases of the CTIX 
system or the UNIX system, these signals will continue to 
behave as described below; they are included only for 
compatibility with some versions of the UNIX system. 
Their use in new programs is strongly discouraged by 
Convergent and AT&T. 


For these signals, fune is assigned one of three values: 
SIG_DFL, SIG_IGN, or a function address. The actions 
prescribed by these values of are as follows: 
SIG_DFL - ignore signal 
The signal is to be ignored. 
SIG_IGN - ignore signal 
The signal is to be ignored. Also, if stg is 
SIGCLD, the calling process’s child processes 


will not create zombie processes when they 
terminate; see ezit(2). 


Pa 
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function address - catch signal 

If the signal is SIGPWR, the action to be 
taken is the same as that described above for 
func equal to function address. The same is 
true if the signal is SIGCLD except, that 
while the process is executing the signal- 
catching function, any received SIGCLD 
signals will be queued and the signal-catching 
function will be continually reentered until 
the queue is empty. 


The SIGCLD affects two other system calls (wat(2), 
and eatt(2)) in the following ways: 


wait If the fune value of SIGCLD is set to 
SIG_IGN and a watt is executed, the wait 
will block until all of the calling process’s 
child processes terminate; it will then return 
a value of —1 with errno set to ECHILD. 


exit If in the exiting process’s parent process the 
func value of SIGCLD is set to SIG_IGN, the 
exiting process will not create a zombie 
process. 


When processing a pipeline, the shell makes the last 
process in the pipeline the parent of the proceeding 
processes. A process that may be piped into in this 
manner (and thus become the parent of other 
processes) should take care not to set SIGCLD to be 
caught. 
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NAME 


SOCKET (2N) 


socket — create an endpoint for communication 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/socket.h> 


socket (af, type, protocol) 
int af, type, protocol; 


DESCRIPTION 
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Socket creates an endpoint for communication and 
returns a descriptor. 


The af parameter specifies an address format with which 
addresses specified in later operations using the socket 
should be interpreted. These formats are defined in the 
include file <sys/socket-h>. The currently 
understood format is 


AF_INET (ARPA Internet addresses). 


The socket has the indicated type which specifies the 
semantics of communication. Currently defined types 
are: 


SOCK_STREAM 
SOCK_DGRAM 
SOCK_RAW 
SOCK_SEQPACKET 
SOCK_RDM 


A SOCK_STREAM type provides sequenced, reliable, 
two-way connection-based byte streams with an out-of- 
band data transmission mechanism. A SOCK_DGRAM 
socket supports datagrams (connectionless, unreliable 
messages of a fixed (typically small) maximum length). 
SOCK_RAW sockets provide access to internal network 
interfaces. The types SOCK_RAW, which is available 
only to the super-user, and SOCK_SEQPACKET and 
SOCK_RDM, which are planned, but not yet 
implemented, are not described here. 


The protocol specifies a particular protocol to be used 
with the socket. Normally only a single protocol exists 
to support a particular socket type using a given address 
format. However, it is possible that many protocols may 
exist in which case a particular protocol must be 
specified in this manner. The protocol number to use is 
particular to the communication domain in which 
communication is to take place; see services(4N) and 
protocols(4N). 


Sockets of type SOCK_STREAM are full-duplex byte 
streams, similar to pipes. A stream socket must be in a 
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connected state before any data may be sent or received 
on it. A connection to another socket is created with a 
connect(2N) call. Once connected, data may be 
transferred using TON) and oie ) calls or some 
variant of the send(2N) and recv ey) calls. When a 
session has been aapeed a close(2) may be 
performed. Out-of-band data may also be transmitted as 
described in send(2N) and received as described in 
recv(2N) 


The communications protocols used to implement a 
SOCK_STREAM insure that data is not lost or 
duplicated. If a piece of data for which the peer protocol 
has buffer space cannot be successfully transmitted 
within a reasonable length of time, then the connection 
is considered broken and calls will indicate an error with 
-1 returns and with ETIMEDOUT as the specific code 
in the global variable errno. The protocols optionally 
keep sockets warm by forcing transmissions roughly 
every minute in the absence of other activity. An error 
is then indicated if no response can be elicited on an 
otherwise idle connection for a extended period (e.g., 5 
minutes). A SIGPIPE signal is raised if a process sends 
on a broken stream; this causes naive processes, which do 
not handle the signal, to exit. 


SOCK_DGRAM and SOCK_RAW sockets allow sending 
of datagrams to correspondents named in send(2N) calls. 
It is also possible to receive datagrams at such a socket 
with recv(2N). 


An fentl(2) call can be used to specify a process group to 
receive a SIGURG signal when the out-of-band data 
arrives. 


The operation of sockets is controlled by socket level 
options. These options are defined in the file 
<sys/socket.h> and explained below. Setsockopt and 
getsockopt(2N) are used to set and get options, 
respectively. 


SO_DEBUG Turn on recording of debugging 
information. 


SO_REUSEADDR Allow local address reuse. 
SO_KEEPALIVE Keep connections alive. 


SO_DONTROUTE Do no apply routing on outgoing 
messages. 


SO_LINGER Linger on close if data present. 
SO_DONTLINGER Do not linger on close. 
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SO_DEBUG enables debugging in the underlying 
protocol modules. SOLREUSEADDR indicates that the 
rules used in validating addresses supplied in a bind(2N) 
call should allow reuse of local addresses. 
SO_KEEPALIVE enables the periodic transmission of 
messages on a connected socket. Should the connected 
party fail to respond to these messages, the connection is 
considered broken and processes using the socket are 
notified via a SIGPIPE signal. SO_DONTROUTE 
indicates that outgoing messages should bypass the 
standard routing facilities. Instead, messages are 
directed to the appropriate network interface according 
to the network portion of the destination address. 
SO_LINGER and SO_DONTLINGER control the 
actions taken when unsent messages are queued on 
socket and a close(2) is performed. If the socket 
promises reliable delivery of data and SO_LINGER is 
set, the system will block the process on the close(2) 
attempt until it is able to transmit the data or until it 
decides it is unable to deliver the information (a timeout 
period, termed the linger interval, is specified in the 
setsockopt call when SO_LINGER is requested). If 
SO_DONTLINGER is specified and a close is issued, the 
system will process the close in a manner which allows 
the process to continue as quickly as possible. 


RETURN VALUE 


A ~1 is returned if an error occurs, otherwise the return 
value is a descriptor referencing the socket. 


ERRORS 


The socket call fails if: 


[EAFNOSUPPORT] The specified address family is not 
supported in this version of the 


system. 
[ESOCK TNOSUPPORT} 
The specified socket type is not 
supported in this address family. 
[EPROTONOSUPPORT] 
The specified protocol is not 
supported. 
[EMF ILE] The per-process descriptor table is 
full. 
[ENOBUFS] No buffer space is available. The 


socket cannot be created. 


SEE ALSO 
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accept(2N), bind(2N), connect(2N), getsockname 
getsockopt(2N), ioctl(2), listen(2N), reev(2N), send 


ON), 
2N 


? 


-3- 
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shutdown(2N), protocols(4N), services(4N). 
“A 4,2BSD Interprocess Communication Primer.”’ 
CTIX Internetworking Manual. 
BUGS 
The use of keepalives is a questionable feature for this 
layer. 
NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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STAT (2) 


NAME 
stat, fstat — get file status 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/stat.h> 


int stat (path, buf) 
char *path; 
struct stat *buf; 


int fstat (fildes, buf) 
int fildes; 
struct stat *buf; 


DESCRIPTION 
Path points to a path name naming a file. Read, write, 
or execute permission of the named file is not required, 
but all directories listed in the path name leading to the 
file must be searchable. Stat obtains information about 
the named file. 


Similarly, fstat obtains information about an open file 
known by the file descriptor fildes, obtained from a 
successful open, creat, dup, fentl, or ptpe system call. 


Buf is a pointer to a stat structure into which 
information is placed concerning the file. 


The contents of the structure pointed to by buf include 
the following members: 


ushort st_mode; /* File mode; see 
mknod(2) #/ 
ino_t st_ino; /* Inode number */ 
dev_t st_dev; /* ID of device containing */ 
/* a directory entry for this file */ 
dev_t st_rdev; /* ID of device */ 


/* This entry is defined only for */ 
/* character special or block #/ 
/* special files */ 


short st_nlink; /* Number of links */ 

ushort st_uid; /* User ID of the file’s owner */ 
ushort st_gid; /* Group ID of the file’s group */ 
off_t st_size; /* File size in bytes */ 

time_t st_atime; /* Time of last access */ 

time_t st_mtime; /* Time of last data modification */ 
time_t st_ctime; /* Time of last file status change */ 


/* Times measured in seconds +/ 
/* since 00:00:00 GMT, Jan. 1, 1970 */ 


st_atime Time when file data was last accessed. 
Changed by the following system calls: 


SIs 
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creat(2), mknod(2), ptpe(2), utime(2), and 
read(2). 
st_mtime Time when data was last modified. Changed 
by the following system calls: creat(2), 
mknod(2), pipe(2), utime(2), and write(2). 
st_ctime Time when file status was last changed. 
Changed by the following system calls: 


chmod(2),  chown({2),  creat(2), —_link(2), 
mknod(2), pipe(2), unlink(2), utime(2), and 
write (2). 
Stat will fail if one or more of the following are true: 
ENOTDIR] A component of the path prefix is not a 
directory. 
ENOENT] The named file does not exist. 
EACCES] Search permission is denied for a 
component of the path prefix. 
EFAULT] Buf or path points to an_ invalid 
address. 
Fstat will fail if one or more of the following are true: 
EBADF] Fildes is not a valid open file 
descriptor. 
EFAULT| Buf points to an invalid address. 


RETURN VALUE 
Upon successful completion a value of O is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 
chmod(2), chown(2), creat(2), link(2), mknod(2), pipe(2), 
read(2), syslocal(2), time(2), unlink(2), utime(2), write(2). 


STIME (2) 


NAME 
stime — set time 
SYNOPSIS 
int stime (tp) 
long *tp; 
DESCRIPTION 
Stime sets the system’s idea of the time and date. Tp 


points to the value of time as measured in seconds from 
00:00:00 GMT January 1, 1970. 


[EPERM] Stime will fail if the effective user ID of 
the calling process is not super-user. 
RETURN VALUE 
Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 
SEE ALSO 
time(2). 
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NAME 
swrite — synchronous write on a file 


SYNOPSIS 
int swrite (fildes, buf, nbyte) 
int fildes; 
char *buf; 
unsigned nbyte; 

DESCRIPTION 
Swrtte has the same purpose and conventions as 
write(2). The two differ solely in their handling of disk 
input/output. Swrite, unlike write, does not give a 
normal return before physical output is complete. A 
program that executes an swrite can assume that the 
data is on the disk, not waiting in a buffer pool. 


SEE ALSO 
creat(2), dup(2), lseek(2), open(2), pipe(2), ulimit(2). 
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NAME 
syne — update super-block 

SYNOPSIS 
void sync ( ) 

DESCRIPTION 
Sync causes all information in memory that should be on 
disk to be written out. This includes modified super 
blocks, modified i-nodes, and delayed block I/O. 
It should be used by programs which examine a file 
system, for example fsck, df, etc. It is mandatory before 
a boot. 
The writing, although scheduled, is not necessarily 
complete upon return from sync. 


SYSLOCAL (2) 


NAME 
syslocal — special system requests 
SYNOPSIS 
#iinclude <syslocal.h> 
int syslocal (emd | , arg |... ) 
int cmd; 
DESCRIPTION 


Syslocal executes certain special system calls. The 
specific call is indicated by the first argument. 
System Type 
int syslocal(SYSL_SYSTEM); 


Return SYSL_MINI for MiniFrame, SYSL_MITI for 
MightyFrame. 


Superblock Resynchronization 


int syslocal(SYSL_LRESYNC, devnum) 
short devnum 


Reread contents of superblock from disk. Deunum 
specifies the file system: the high order byte contains the 
major device number of the character special device; the 
low order byte contains the minor device number. Only 
the super-user may do this. 


Enable Openi 


syslocal(SYSL_OPENI, flag) 
int flag 


Enables or disables the opent system call. Flag is 1 for 
enabling, 0 for disabling. Only the superuser can execute 
this call, which affects every user on the system. 


Maximum Number of Users 


syslocal(SYSL_MAXUSERS) 
Returns maximum number of concurrent logins on the 
processor on which this process is executing. 


Kernel Addresses 


syslocal(SYSL_KADDR, arg) 


Returns certain addresses of kernel data structures. This 
allows certain programs (ps, killall) to run properly, even 
if /unix is not currently running. Arg is one of the 
following: 


SLA_V return address of var _— structure 


(sys/var.h) 
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SLA_PROC return address of proc structure 


(sys/proc.h) 

SLA_ERR return address of err structure 
(sys/err.h) 

SCA_TIME return address of int time 

SLA_CDT return address of crash dump _ table 


(CDT) = (sys/hardware.h) 
SLA_GDUTAB return address of gdutab (sys/iobuf.h) 
SLA_USRSTK return highest address of user stack 


SLA_USIGN return signature of running UNIX (may 
be compared with that of /unix to see 
if they are identical) 


SLA_MEM return number of bytes of physical 
memory 


SLA_BDEVCNT 
return the number of slots in struct 
bdevsw (sys/conf.h) 


SLA_CDEVCNT 
return the number of slots in struct 
cdevsw (sys/conf.h) 


Object Module Type 


syslocal(SYSL_0413MAGIC) 


On 1 if the kernel can support the —F option of 
Id(). 


Read Real-Time Clock (MightyFrame Only) 


syslocal(SYSL_RDRTC, arg) 


Read current state of real-time (battery supported) clock. 
Arg is a pointer to struct rtc (sys/rtc.h) 


Write Real-Time Clock (MightyFrame Only) 


syslocal(SYSL_WTRTC, arg) 


Write new state of real-time clock. Arg is a pointer to a 
struct rte (sys/rtc. ys EIO is returned if any of the 
values are vest nly the super-user may write the 
real-time clock. 


Reboot System 


syslocal(SYSL_REBOOT) 
Force a software reset. Only the superuser may reset. 
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Allocate a Loadable Driver 


syslocal(SYSL_ALLOCDRY, option, arg) 


Allocate/deallocate virtual space for a loadable driver. 
See /ddrv(2) for more information. Only the super-user 
may do this. 


Bind a Loadable Driver 


syslocal(SYSL_BINDDRYV, option, arg) 


Bind/unbind a loadable driver. See /ddrv(2) for more 
information. Only the super-user may do this. 


Determine Processor Type 


syslocal(SYSL_PROCESSOR) 


Returns a value that may be used to determine on what 
kind of processor (e.g., 68010 or 68020) is running and 
whether floating-point hardware (e.g., (68881) is 
available. 


MightyFrame Hardware Configuration (MightyFrame 
Only) 
syslocal(SYSL_MITICFIG) 


Returns a bit mask of the hardware that is present. 
Values can be found in syslocal.h. A more convenient 
way to get this information is via hinv(1M). 


Syslocal will fail if one of the following is true: 


[EINVAL] emd or any suboption is illegal. 
[EFAULT] An arg points outside the process’s 
space. 
SEE ALSO 


fsck(1M), lddrv(2), openi(2). 

MightyFrame Adminitstrator’s Reference Manual. 
WARNINGS 

Kernel prints and the kernel debugger syslocal calls that 

support them may disappear without notice. Use of 

kernel prints degrades system performance. Use of the 

kernel debugger halts normal processing. 
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NAME 
time — get time 
SYNOPSIS 
long time ((long *) 0) 
long time (tloc) 
long *tloc; 
DESCRIPTION 
Time returns the value of time in seconds since 00:00:00 
GMT, January 1, 1970. 


If tloc (taken as an integer) is non-zero, the return value 
is also stored in the location to which éloc points. 
[EFAULT|] Time will fail if tloe points to an illegal 
address. 

RETURN VALUE 
Upon successful completion, time returns the value of 
time. Otherwise, a value of —1 is returned and errno is 
set to indicate the error. 

SEE ALSO 
stime(2). 
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NAME 
times — get process and child process times 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/times.h> 


long times (buffer) 
struct tms *buffer; 


DESCRIPTION 
Times fills the structure pointed to by buffer with time- 
accounting information. The following are the contents 
of this structure: 


struct tms { 

time_t tms_utime; 

time_t tms_stime; 

time_t tms_cutime; 

time_t tms_cstime; 
} 
This information comes from the calling process and 
each of its terminated child processes for which it has 
executed a watt. All times are in 60ths of a second. 


Tms_utime is the CPU time used while executing 
instructions in the user space of the calling process. 


Tms_stime is the CPU time used by the system on behalf 
of the calling process. 


Tms_cutime is the sum of the tms_utimes and 
tms_cutimes of the child processes. 


Tms_estime is the sum of the tms_stimes and 
tms_cestimes of the child processes. 


[EFAULT] Times will fail if buffer points to an illegal 
address. 


RETURN VALUE 
Upon successful completion, times returns the elapsed 
real time, in 60ths of a second, since an arbitrary point 
in the past (-8., system start-up time). This point does 
not change from one invocation of times to another. If 
times fails, a —1 is returned and errno is set to indicate 
the error. 


SEE ALSO 
exec(2), fork(2), time(2), wait(2). 


NAME 


ULIMIT (2) 


ulimit — get and set user limits 


SYNOPSIS 


long ulimit (emd, newlimit) 
int cmd; 
long newlimit; 


DESCRIPTION 
This function provides for control over process limits. 
The cmd values available are: 


1 


3 


Get the file size limit of the process. The limit is 
in units of 512-byte blocks and is inherited by child 
processes. Files of any size can be read. 


Set the file size limit of the process to the value of 
newltmit. Any process may decrease this limit, but 
only a process with an effective user ID of super- 
user may increase the limit. Ulimté will fail and 
the limit will be unchanged if a process with an 
effective user ID other than super-user attempts to 
increase its file size limit. [EPERM] 


Get the maximum possible break value. See 


brk(2). 


RETURN VALUE 
Upon successful completion, a non-negative value is 
returned. Otherwise, a value of —1 is returned and 
errno is set to indicate the error. 


SEE ALSO 


brk(2), write(2). 
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NAME 
umask — set and get file creation mask 


SYNOPSIS 
int umask (cmask) 
int cmask; 


DESCRIPTION 
Umask sets the process’s file mode creation mask to 
cmask and returns the previous value of the mask. Only 
the low-order 9 bits of cmask and the file mode creation 
mask are used. 


RETURN VALUE 
The previous value of the file mode creation mask is 
returned. 


SEE ALSO 
mkdir(1), sh(1), chmod(2), creat(2), mknod(2), open(2). 
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NAME 
umount — unmount a file system 

SYNOPSIS 
int umount (spec) 
char *spec; 

DESCRIPTION 
Umount requests that a previously mounted file system 
contained on the block special device identified by spec 
be unmounted. Spec is a pointer to a path name. After 
unmounting the file system, the directory upon which 


the file system was mounted reverts to its ordinary 
interpretation. 


Umount may be invoked only by the super-user. 


Umount will fail if one or more of the following are true: 


EPERM] The process’s effective user ID is not 
super-user. 

ENXIO} Spec does not exist. 

ENOTBLK] Spec is not a block special device. 

EINVAL] Spec is not mounted. 

EBUSY] A file on spec is busy. 

EFAULT] Spec points to an illegal address. 


RETURN VALUE 
Upon successful completion a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 
mount(2). 
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NAME 
uname — get name of current CTIX system 


SYNOPSIS 
#include <sys/utsname.h> 


int uname (name) 
struct utsname *name; 


DESCRIPTION 
Uname stores information identifying the current CTIX 
system in the structure pointed to by name. 


Uname uses the structure defined in 
<sys/utsname.h> whose members are: 


char sysname[9 
char nodename 
char __ release[9}; 
char __ version|9]; 
char _machine[9]; 


, 


9); 


Uname returns a null-terminated character string 
naming the current CTIX system in the character array 
sysname. Similarly, nodename contains the name that 
the system is known by on a communications network. 
Release and version further identify the operating 
system. Machine contains a standard name _ that 
identifies the hardware that the CTIX system is running 
on. 


[EFAULT] Uname will fail if name points to an invalid 
address. 

RETURN VALUE 
Upon successful completion, a non-negative value is 
returned. Otherwise, —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 
uname(1). 


NAME 


UNLINK (2) 


unlink — remove directory entry 


SYNOPSIS 


int unlink (path) 


char *path; 
DESCRIPTION 


Unlink removes the directory entry named by the path 
name pointed to by path. 


The named file is unlinked unless one or more of the 
following are true: 


ENOTDIR] 


ENOENT] 
EACCES| 


EACCES| 


EPERM} 


EBUSY] 


ETXTBSY] 


EROFS| 


EFAULT] 


A component of the path prefix is not a 
directory. 


The named file does not exist. 


Search permission is denied for a 
component of the path prefix. 


Write permission is denied on the 
directory containing the link to be 
removed. 


The named file is a directory and the 
effective user ID of the process is not 
super-user. 


The entry to be unlinked is the mount 
point for a mounted file system. 


The entry to be unlinked is the last link 
to a pure procedure (shared text) file 
that is being executed. 


The directory entry to be unlinked is 
part of a read-only file system. 


Path points outside the process’s 
allocated address space. 


When all links to a file have been removed and no 
process has the file open, the space occupied by the file 
is freed and the file ceases to exist. If one or more 
processes have the file open when the last link is 
removed, the removal is postponed until all references to 
the file have been closed. 


RETURN VALUE 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


rm(1), close(2), link(2), open(2). 
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ustat — get file system statistics 


SYNOPSIS 


#include <sys/types.h> 
#include <ustat.h> 


int ustat (dev, buf) 
int dev; 
struct ustat *buf; 


DESCRIPTION 


Ustat returns information about a mounted file system. 
Dev is a device number identifying a device containing a 
mounted file system. Buf is a pointer to a ustat 
structure that includes to following elements: 


daddr_t f_tfree; /* Total free blocks */ 

ino_t f_tinode; /* Number of free inodes */ 

char {_fname(6]; /* Filsys name */ 

char f_fpack|6]; /* Filsys pack name */ 

Ustat will fail if one or more of the following are true: 

[EINVAL] Dev is not the device number of a 
device containing a mounted file 
system. 

{EFAULT] Buf points outside the process’s 


allocated address space. 


RETURN VALUE 


Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 


stat(2), fs(4). 


NAME 


UTIME (2) 


utime — set file access and modification times 


SYNOPSIS 


#include <sys/types.h> 
int utime (path, times) 
char *path; 

struct utimbuf *times; 


DESCRIPTION 


Path points to a path name naming a file. Utime sets 
the access and modification times of the named file. 


If times is NULL, the access and modification times of 
the file are set to the current time. A process must be 
the owner of the file or have write permission to use 
utime in this manner. 


If times is not NULL, times is interpreted as a pointer 
to a utimbuf structure and the access and modification 
times are set to the values contained in the designated 
structure. Only the owner of the file or the super-user 
may use utime this way. 


The times in the following structure are measured in 
seconds since 00:00:00 GMT, Jan. 1, 1970. 
struct utimbuf{ 

time_t actime; /* access time */ 

time_t modtime; /* modification time */ 


Utime will fail if one or more of the following are true: 


ENOENT] The named file does not exist. 

ENOTDIR] A component of the path prefix is not a 
directory. 

EACCES] Search permission is denied by a 
component of the path prefix. 

EPERM| The effective user ID is not super-user 
and not the owner of the file and times 
is not NULL. 

EACCES] The effective user ID is not super-user 


and not the owner of the file and times 
is NULL and write access is denied. 


EROFS] The file system containing the file is 
mounted read-only. 

EFAULT] Times is not NULL and points outside 
the process’s allocated address space. 

EFAULT] Path points outside the process’s 


allocated address space. 
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RETURN VALUE 
Upon successful completion, a value of O is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
stat(2). 
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NAME 


WAIT (2) 


wait — wait for child process to stop or terminate 


SYNOPSIS 


int wait (stat_loc) 
int *stat_loc; 


int wait ((int *)0) 


DESCRIPTION 


Wait suspends the calling process until one of the 
immediate children terminates or until a child that is 
being traced stops because it has hit a break point. The 
watt system call will return prematurely if a signal is 
received and if a child process stopped or terminated 
prior to the call on wart, return is immediate. 


If stat_loc (taken as an integer) is non-zero, 16 bits of 
information called status are stored in the low order 16 
bits of the location pointed to by stat_loc. Status can 
be used to differentiate between stopped and terminated 
child processes and if the child process terminated, status 
identifies the cause of termination and passes useful 
information to the parent. This is accomplished in the 
following manner: 


If the child process stopped, the high order 8 bits 
of status will contain the number of the signal 
that caused the process to stop and the low 
order 8 bits will be set equal to 0177. 


If the child process terminated due to an ezit 
call, the low order 8 bits of status will be zero 
and the high order 8 bits will contain the low 
order 8 bits of the argument that the child 
process passed to eztt; see eztt(2). 


If the child process terminated due to a signal, 
the high order 8 bits of status will be zero and 
the low order 8 bits will contain the number of 
the signal that caused the termination. In 
addition, if the low order seventh bit (i.e., bit 
200) is set, a “core image” will have been 
produced; see signal(2). 


If a parent process terminates without waiting for its 
child processes to terminate, the parent process ID of 
each child process is set to 1. This means the 
initialization process inherits the child processes; see 
intro(2). 

Wart will fail and return immediately if one or more of 
the following are true: 
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[ECHILD] The calling process has no existing 
unwaited-for child processes. 
{[EFAULT] Stat_loc points to an illegal address. 


RETURN VALUE 
If watt returns due to the receipt of a signal, a value of 
-1 is returned to the calling process and errno is set to 
EINTR. If watt returns due to a stopped or terminated 
child process, the process ID of the child is returned to 
the calling process. Otherwise, a value of —1 is returned 
and errno is set to indicate the error. 


SEE ALSO 
exec(2), exit(2), fork(2), intro(2), pause(2), ptrace(2), 
signal(2). 


WARNING 
See WARNING in stgnal(2). 


ya 


NAME 


WRITE(2) 


write — write on a file 


SYNOPSIS 


int write (fildes, buf, nbyte) 
int fildes; 

char *buf; 

unsigned nbyte; 


DESCRIPTION 


Fildes is a file descriptor obtained from a creat, open, 
dup, fentl, or pipe system call. 


Write attempts to write nbyte bytes from the buffer 
pointed to by buf to the file associated with the fildes. 


On devices capable of seeking, the actual writing of data 
proceeds from the position in the file indicated by the 
file pointer. Upon return from wrtte, the file pointer is 
incremented by the number of bytes actually written. 


On devices incapable of seeking, writing always takes 
place starting at the current position. The value of a file 
pointer associated with such a device is undefined. 


If the O_APPEND flag of the file status flags is set, the 
file pointer will be set to the end of the file prior to each 
write. 


Write will fail and the file pointer will remain 
unchanged if one or more of the following are true: 


[EBADF] Fildes is not a valid file descriptor open 
for writing. 


[EPIPE and SIGPIPE signal] 
An attempt is made to write to a pipe 
that is not open for reading by any 
process. 


[EFBIG] An attempt was made to write a file 
that exceeds the process’s file size limit 
or the maximum file size. See ulimit(2). 


[EFAULT] Buf points outside the process’s 
allocated address space. 
[EINTR] A signal was caught during the write 


system call. 


{[EDEADLOCK] A side effect of a previous locking(2) 
call. 

If a wrtte requests that more bytes be written than there 

is room for (e.g., the ulimit (see ultmtt(2)) or the physical 

end of a medium), only as many bytes as there is room 

for will be written. For example, suppose there is space 


Nip 


WRITE (2) 


for 20 bytes more in a file before reaching a limit. A 
write of 512 bytes will return 20. The next write of a 
non-zero number of bytes will give a failure return 
(except as noted below). 


If the file being written is a pipe (or FIFO) and the 
O_NDELAY flag of the file flag word is set, then write to 
a full pipe (or FIFO) will return a count of 0. Otherwise 
(O_NDELAY clear), writes to a full pipe (or FIFO) will 
block until space becomes available. 


RETURN VALUE 
Upon successful completion the number of bytes actually 
written is returned. Otherwise, —1 is returned and errno 
is set to indicate the error. 


SEE ALSO 
creat(2), dup(2), Iseek(2), locking(2), open(2), pipe(2), 
ulimit(2). 


NAME 


INTRO(3) 


intro — introduction to subroutines and libraries 


SYNOPSIS 


#include <stdio.h> 
#include <math.h> 


DESCRIPTION 


This section describes functions found in various 
libraries, other than those functions that directly invoke 
CTIX system primitives, which are described in Section 2 
of this volume. Certain major collections are identified 
by a letter after the section number: 


(3C) These functions, together with those of Section 2 
and those marked (3S), constitute the Standard C 
Library ltbe, which is automatically loaded by the 
C compiler, ec(1). The link editor /d(1) searches 
this library under the —le option. Declarations for 
some of these functions may be obtained from 
#include files indicated on the appropriate 
pages. 

(3M) These functions constitute the Math Library, 
lthm. They are not automatically loaded by the 
C compiler, ec(1); however, the link editor 
searches this library under the —Im_ option. 
Declarations for these functions may be obtained 
from the #include file <math.h>. 

(3N) These functions are for use with a special version 
of the CTIX kernel that supports networking 
protocols. The link editor searches these library 
functions under the -l socket option. For 
further information, see the CTIX Internetworking 
Manual. 

(3S) These functions constitute the “standard I/O 
package”’ (see stdio(3S)). These functions are in 
the library ithe, already mentioned. Declarations 
for these functions may be obtained from the 
#include file <stdio.h>. 

(3X) Various specialized libraries. The files in which 
these libraries are found are given on the 
appropriate pages. 


DEFINITIONS 


A character is any bit pattern able to fit into a byte on 
the machine. The null character is a character with 
value 0, represented in the C language as ’\0’. A 
character array is a sequence of characters. null- 
terminated character array is a sequence of characters, 
the last of which is the null character. A string is a 
designation for a null-terminated character array. The 


oe ee 


FILES 


INTRO(3) 


null string is a character array containing only the null 
character. A NULL pointer is the value that is obtained 
by casting O into a pointer. The C language guarantees 
that this value will not match that of any legitimate 
pointer, so many functions that return pointers return it 
to indicate an error. NULL is defined as O in 
<stdio.h>; the user can include an appropriate 
definition if he is not using <stdio.h>. 


/lib/libe.a 
/lib/libm.a 
/lib /libsocket.a 


SEE ALSO 


ar(1), cc(1), Id(1), nm(1), intro(2), stdio(3S). 
CTIX Internetworking Manual. 


DIAGNOSTICS 


Functions in the C and Math Libraries (3M) may return 
the conventional values 0 or +HUGE (the largest- 
magnitude single-precision floating-point numbers; 
HUGE is defined in the <math.h> header file) when the 
function is undefined for the given arguments or when 
the value is not representable. In these cases, the 
external variable errno (see tntro(2)) is set to the value 
EDOM or ERANGE. 


WARNING 


Many of the functions in the libraries call and/or refer to 
other functions and external variables described in this 
section and in section 2 (System Calls). If a program 
inadvertantly defines a function or external variable with 
the same name, the presumed library version of the 
function or external variable may not be loaded. The 
lint(1) program checker reports name conflicts of this 
kind as ‘‘multiple declarations” of the names in question. 
Definitions for sections 2, 3C, and 3S are checked 
automatically. Other definitions can be included by 
using the -l option (for example, —Im_ includes 
definitions for the Math Library, section 3M). Use of lint 
is highly recommended. 


NAME 


A64L(3C) 


a64!, 164a — convert between long integer and base-64 
ASCII string 


mm SYNOPSIS 


long a64l (s) 
char *s; 

char *164a (1) 
long 1; 


DESCRIPTION 


BUGS 


These functions are used to maintain numbers stored in 
base-64 ASCII characters. This is a notation by which 
long integers can be represented by up to six characters; 
each character represents a “digit”? in a radix-64 
notation. 


The characters used to represent “digits” are . for 0, 
for 1, O through 9 for 2-11, A through Z for 12-37, and 
a through z for 38-63. 


A64l takes a pointer to a null-terminated base-64 
representation and returns a corresponding long value. 
If the string pointed to by s contains more than six 
characters, a64l will use the first six. 


L64a takes a long argument and returns a pointer to the 
corresponding base-64 representation. If the argument is 
0, [64a returns a pointer to a null string. 


The value returned by /64a is a pointer into a static 
buffer, the contents of which are overwritten by each 
call. 


ABORT (3C) 


NAME 
abort — generate an IOT fault 


SYNOPSIS 
int abort ( ) 


DESCRIPTION 
Abort first closes all open files if possible, then causes an 
IOT signal to be sent to the process. This usually results 
in termination with a core dump. 


It is possible for abort to return control if SIGIOT is 
caught or ignored, in which case the value returned is 
that of the kill(2) system call. 


SEE ALSO 
adb(1), sdb(1), exit(2), kill(2), signal(2). 
DIAGNOSTICS 
If SIGIOT is neither caught nor ignored, and the current 


directory is writable, a core dump is produced and the 
message “‘abort — core dumped”’ is written by the shell. 


ABS(3C) 


NAME 
abs — return integer absolute value 
SYNOPSIS 
int abs (i) 
int i; 
DESCRIPTION 
Abs returns the absolute value of its integer operand. 
BUGS 
In two’s-complement representation, the absolute value 
of the negative integer with largest magnitude is 
undefined. Some implementations trap this error, but 
others simply ignore it. 
SEE ALSO 
floor(3M). 


ASSERT (3X) 


NAME 
assert — verify program assertion 


SYNOPSIS 
#include <assert.h> 


assert (expression) 
int expression; 


DESCRIPTION 
This macro is useful for putting diagnostics into 
rograms. When it is executed, if ezpresston is false 
leroy assert prints 


“Assertion failed: expresston, file zyz, line nnn” 


on the standard error output and aborts. In the error 
message, ryz is the name of the source file and nnn the 
source line number of the assert statement. 


Compiling with the preprocessor option -DNDEBUG 
(see cpp(1)), or with the preprocessor control statement 
“‘#define NDEBUG” ahead of the ‘“‘#include 
<assert.h>”’ statement, will stop assertions from being 
compiled into the program. 


SEE ALSO 
epp(1), abort(3C). 


ATOF(3C) 


atof — convert ASCII string to floating-point number 


SYNOPSIS 


double atof (nptr) 
char *nptr; 


DESCRIPTION 


Atof converts a character string pointed to by npir toa 
double-precision floating-point number. The first 
unrecognized character ends the conversion. Atof 
recognizes an optional string of white-space characters, 
then an optional sign, then a string of digits optionally 
containing a decimal point, then an optional e or E 
followed by an optionally signed integer. If the string 
begins with an unrecognized character, atof returns the 
value zero. 


DIAGNOSTICS 


When the correct value would overflow, atof returns 
HUGE, and sets errno to ERANGE. Zero is returned 
on underflow. 


SEE ALSO 


scanf{(3S). 


BESSEL (3M) 


j0, jl, jn, yO, yl, yn — Bessel functions 


SYNOPSIS 


#include <math.h> 
double jO (x) 
double x; 

double jl (x) 
double x; 

double jn (n, x) 

int n; 

double x; 


double yO (x) 
double x; 
double y1 (x) 
double x; 
double yn (n, x) 
int n; 

double x; 


DESCRIPTION 


JO and j1 return Bessel functions of z of the first kind of 
orders 0 and 1 respectively. Jn returns the Bessel 
function of z of the first kind of order n. 


YO and yi return Bessel functions of z of the second 
kind of orders 0 and 1 respectively. Yn returns the 
Bessel function of z of the second kind of order n. The 
value of z must be positive. 


DIAGNOSTICS 


Non-positive arguments cause y0, yl and yn to return 
the value -HUGE and to set errno to EDOM. In 
addition, a message indicating DOMAIN error is printed 
on the standard error output. 


Arguments too large in magnitude cause j0, j1, yO and 
yl to return zero and to set errno to ERANGE. In 
addition, a message indicating TLOSS error is printed on 
the standard error output. 


These error-handling procedures may be changed with 
the function matherr(3M). 


SEE ALSO 


matherr(3M). 


BSEARCH (3C) 


NAME 
bsearch — binary search a sorted table 


SYNOPSIS 
#include <search.h> 


char *bsearch ((char *) key, (char *) base, nel, 
sizeof (*key), compar) 

unsigned nel; 

int (*compar)( ); 


DESCRIPTION 

Bsearch is a binary search routine generalized from 
Knuth (6.2.1) Algorithm B. It returns a pointer into a 
table indicating where a datum may be found. The 
table must be previously sorted in increasing order 
according to a provided comparison function. Key 
points to a datum instance to be sought in the table. 
Base points to the element at the base of the table. Nel 
is the number of elements in the table. Compar is the 
name of the comparison function, which is called with 
two arguments that point to the elements being 
compared. The function must return an integer less 
than, equal to, or greater than zero as accordinly the 
first argument is to be considered less than, equal to, or 
greater than the second. 


EXAMPLE 
The example below searches a table containing pointers 
to nodes consisting of a string and its length. The table 
is ordered alphabetically on the string in the node 
pointed to by each entry. 


This code fragment reads in strings and either finds the 
corresponding node and prints out the string and its 
length, or prints an error message. 


#include <stdio.h> 
#include <search.h> 


#define TABSIZE 1000 


struct node { /* these are stored in the table #/ 
char *string; 
int length; 

} 


struct node table[TABSIZE]; —/* table to be searched */ 


struct node *node_ptr, node; 


“ls 
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int node_compare( ); /# routine to compare 2 nodes */ 
char str_space|20|; /* space to read string into */ 


node.string = str_space; 
while (scanf(”%s”, node.string) != EOF) { 
node_ptr = (struct node *)bsearch((char *)(&node), 
(char *)table, TABSIZE, 
sizeof(struct node), node_compare); 
if (node_ptr != NULL) { 
(void)printf("string = %20s, length = %d\n”, 
node_ptr— >string, node_ptr- >length); 


} else { 
(void)printf("not found: %s\n”, node.string); 
} 
} 
/* 
This routine compares two nodes based on an 
alphabetical ordering of the string field. 
*/ 
int 


node_compare(nodel, node2) 
struct node *nodel, *node2; 


{ 


} 


NOTES 
The pointers to the key and the element at the base of 
the table should be of type pointer-to-element, and cast 
to type pointer-to-character. 
The comparison function need not compare every byte, 
so arbitrary data may be contained in the elements in 
addition to the values being compared. 
Although declared as type pointer-to-character, the value 
returned should be cast into type pointer-to-element. 


SEE ALSO 
hsearch(3C), Isearch(3C), gsort(3C), tsearch(3C). 


DIAGNOSTICS 


A NULL pointer is returned if the key cannot be found in 
the table. 


return stremp(nodel~ >string, node2- >string); 


BYTEORDER (3N ) 


NAME 
htonl, htons, ntohl, ntohs — convert values between host 
and network byte order 


_—~ SYNOPSIS 
#include <sys/types.h> 
#include <sys/in.h> 


netlong = htonl(hostlong); 
unsigned long netlong, hostlong; 


netshort — htons(hostshort); 
ushort netshort, hostshort; 


hostlong = ntohl(netlong); 
unsigned long hostlong, netlong; 


hostshort = ntohs(netshort); 
ushort hostshort, netshort; 


DESCRIPTION 
These routines convert 16 and 32 bit quantities between 
network byte order and host byte order. On machines 
such as the MiniFrame these routines are defined as null 
macros in the include file <sys/in.h>. 


These routines are most often used in conjunction with 
Internet addresses and ports as returned’ by 
~~ gethostent(3N) and getservent(3N). 
SEE ALSO 
gethostent(3N), getservent(3N). 
CTIX Internetworking Manual. 
NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NAME 


CLOCK (3C) 


clock — report CPU time used 


SYNOPSIS 


long clock ( ) 


DESCRIPTION 


Clock returns the amount of CPU time (in microseconds) 
used since the first call to clock. The time reported is 
the sum of the user and system times of the calling 
process and its terminated child processes for which it 
has executed wait(2) or system(3S). 


The resolution of the clock is 16.667 milliseconds on 
CTIX Processors. 


SEE ALSO 


BUGS 


times(2), wait(2), system(3S). 


The value returned by clock is defined in microseconds 
for compatibility with systems that have CPU clocks 
with much higher resolution. Because of this, the value 
returned will wrap around after accumulating only 2147 
seconds of CPU time (about 36 minutes). 


~— 
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NAME 
toupper, tolower, _toupper, _tolower, toascii — translate 
characters 

SYNOPSIS 
#include <ctype.h> 
int toupper (c) 
int ¢; 
int tolower (c) 
int c; 
int _toupper (c) 
int ¢; 
int _tolower (c) 
int ¢; 
int toascii (c) 
int ¢; 

DESCRIPTION 
Toupper and tolower have as domain the range of 
getc(3S): the integers from -1 through 255. If the 
argument of toupper represents a lower-case letter, the 
result is the corresponding upper-case letter. If the 
argument of tolower represents an upper-case letter, the 
result is the corresponding lower-case letter. All other 
arguments in the domain are returned unchanged. 
The macros _toupper and _tolower, are macros that 
accomplish the same thing as toupper and tolower but 
have restricted domains and are faster. _toupper 
requires a lower-case letter as its argument; its result is 
the corresponding upper-case letter. The macro _ftolower 
requires an upper-case letter as its argument; its result is 
the corresponding lower-case letter. Arguments outside 
the domain cause undefined results. 
Toasctt yields its argument with all bits turned off that 
are not part of a standard ASCII character; it is intended 
for compatibility with other systems. 

SEE ALSO 


ctype(3C), getc(3S). 


CRYPT (3C) 


NAME 
crypt, setkey, encrypt — generate hashing encryption 


SYNOPSIS 
char *crypt (key, salt) 
char *key, *salt; 


void setkey (key) 
char *key; 


void encrypt (block, fake) 
char *block; 
int fake; 


DESCRIPTION 
Crypt is the password encryption function. It is based 
on a one way hashing encryption algorithm with 
variations intended (among other things) to frustrate use 
of hardware implementations of a key search. 


Key is a user’s typed password. Salt is a two-character 
string chosen from the set [a-zA-Z0-9./]; this string is 
used to perturb the hashing algorithm in one of 4096 
different ways, after which the password is used as the 
key to encrypt repeatedly a constant string. The 
returned value points to the encrypted password. The 
first two characters are the salt itself. 


The setkey and encrypt entries provide (rather primitive) 
access to the actual hashing algorithm. The argument of 
setkey is a character array of length 64 containing only 
the characters with numerical value 0 and 1. If this 
string is divided into groups of 8, the low-order bit in 
each group is ignored; this gives a 56-bit key which is set 
into the machine. This is the key that will be used with 
the hashing algorithm to encrypt the string block with 
the function encrypt. 


The argument to the encrypt entry is a character array 
of length 64 containing only the characters with 
numerical value 0 and 1. The argument array is 
modified in place to a similar array representing the bits 
of the argument after having been subjected to the 
hashing algorithm using the key set by setkey. Fake is 
not used and is ignored, but should be present if lint(1) 
is used. 


SEE ALSO 
login(1), passwd(1), getpass(3C), passwd(4). 


BUGS 
The return value points to static data that are 
overwritten by each call. 


NAME 


CTERMID (38) 


ctermid — generate file name for terminal 


SYNOPSIS 


#include <stdio.h> 


char *ctermid(s) 
char *s; 


DESCRIPTION 


NOTES 


Ctermid generates the path name of the controlling 
terminal for the current process, and stores it in a string. 


If s is a NULL pointer, the string is stored in an internal 
static area, the contents of which are overwritten at the 
next call to ctermtd, and the address of which is 
returned. Otherwise, s is assumed to point to a 
character array of at least L_ctermid elements; the 
path name is placed in this array and the value of s is 
returned. The constant L_ctermid is defined in the 
<stdio.h> header file. 


The difference between ctermid and ttyname(3C) is that 
ttyname must be handed a file descriptor and returns the 
actual name of the terminal associated with that file 
descriptor, while ctermid returns a string (/dev/tty) 
that will refer to the terminal if used as a file name. 
Thus ttyname is useful only if the process already has at 
least one file open to a terminal. 


SEE ALSO 


ttyname(3C). 


CTIME(3C) 


NAME 
ctime, localtime, gmtime, asctime, tzset — convert date 
and time to string 

SYNOPSIS 
#include <time.h> 


char *ctime (clock) 
long *clock; 


struct tm *localtime (clock) 
long *clock; 


struct tm *gmtime (clock) 
long *clock; 


char *asctime (tm) 
struct tm *tm; 


extern long timezone; 
extern int daylight; 
extern char *tzname(2]; 
void tzset ( ) 


DESCRIPTION 
Ctime converts a long integer, pointed to by clock, 
representing the time in seconds since 00:00:00 GMT, 
January 1, 1970, and returns a pointer to a 26-character 


string in the following form. All the fields have constant 
width. 


Sun Sep 16 01:03:52 1973\n\0 


Localtime and gmttme return pointers to ‘‘tm” 
structures, described below. Localtime corrects for the 
time zone and possible Daylight Savings Time; gmtime 
converts directly to Greenwich Mean Time (GMT), which 
is the time the CTIX system uses. 


Asctime converts a ‘‘tm’”’ structure to a 26-character 
string, as shown in the above example, and returns a 
pointer to the string. 


Declarations of all the functions and externals, and the 
“tm” structure, are in the <ttme.h> header file. The 
structure declaration is: 


struct tm { 


int tm_sec; /* seconds (0 - 59) */ 

int tm_min; /* minutes (0 - 59) */ 

int tm_hour; /* hours (0 - 23) */ 

int tm_mday; /* day of month (1 - 31) */ 
int tm_mon; /* month of year (0 - 11) */ 


int tm_year; /* year — 1900 i 
int tm_wday; /* day of week (Sunday = 0) */ 


-l- 


CTIME(3C) 


int tm_yday; /* day of year (0 - 365) */ 

int tm_isdst; 
Tm_isdst is non-zero if Daylight Savings Time is in 
effect. 


The external long variable timezone contains the 
difference, in seconds, between GMT and local standard 
time (in EST, timezone is 5*60*60); the external variable 
daylight is non-zero if and only if the standard U.S.A. 
Daylight Savings Time conversion should be applied. 
The program knows about the peculiarities of this 
conversion in 1974 and 1975; if necessary, a table for 
these years can be extended. 


If an environment variable named TZ is present, asctime 
uses the contents of the variable to override the default 
time zone. The value of TZ must be a three-letter time 
zone name, followed by a number representing the 
difference between local time and Greenwich Mean Time 
in hours, followed by an optional three-letter name for a 
daylight time zone. For example, the setting for New 
Jersey would be EST5EDT. The effects of setting TZ 
are thus to change the values of the external variables 
timezone and daylight; in addition, the time zone names 
contained in the external variable 


char *tzname(2] = { "EST", "EDT" }; 
are set from the environment variable TZ. The function 
tzset sets these external variables from TZ; tzset is 


called by asctime and may also be called explicitly by 
the user. 


Note that in most installations, TZ is set by default 
when the user logs on, to a value in the local /etc/profile 
file (see profile(4)) 

SEE ALSO 
time(2), getenv(3C), profile(4), environ(5). 

BUGS 


The return values point to static data whose content is 
overwritten by each call. 


CTYPE(3C) 


NAME 
isalpha, isupper, islower, isdigit, isxdigit, isalnum, 
isspace, ispunct, isprint, isgraph, iscntrl, isascii — classify 
characters 

SYNOPSIS 
#include <ctype.h> 
int isalpha (c) 
int c; 


DESCRIPTION 
These macros classify character-coded integer values by 
table lookup. Each is a predicate returning nonzero for 
true, zero for false. Jsascst is defined on all integer 
values; the rest are defined only where tsascii is true and 
on the single non-ASCII value EOF (-1 — see stdio(3S)). 


isalpha c is a letter. 

wupper c is an upper-case letter. 

tslower ¢ is a lower-case letter. 

isdigtt c is a digit [0-9]. 

isadigit ce is a hexadecimal digit [0-9], [A-F] or 
{a-f]. 

tsalnum ¢c is an alphanumeric (letter or digit). 

tsspace c is a space, tab, carriage return, new- 
line, vertical tab, or form-feed. 

ispunct c is a punctuation character (neither 
control nor alphanumeric). 

isprint ec is a printing character, code 040 
(space) through 0176 (tilde). 

isgraph ec is a printing character, like isprint 
except false for space. 

iscnirl c is a delete character (0177) or an 
ordinary control character (less than 
040). 

isascit ec is an ASCII character, code less than 
0200. 

DIAGNOSTICS 


If the argument to any of these macros is not in the 
domain of the function, the result is undefined. 


SEE ALSO 
ascii(5). 


~~ 


NAME 


CURSES (3X) 


curses — CRT screen handling and optimization package 


SYNOPSIS 


#include <curses.h> 
ec { flags | files —lcurses [ libraries | 


DESCRIPTION 


5/86 


These routines give the user a method of updating 
screens with reasonable optimization. In order to 
initialize the routines, the routine inttser{} must be 
called before any of the other routines that deal with 
windows and screens are used. The routine endwin( } 
should be called before exiting. To get character-at-a- 
time input without echoing, (most interactive, screen 
oriented-programs want this] after calling initser{ ) you 
should call “‘nonl( ); cbreak( ); noecho( };”’ 


The full curses interface permits manipulation of data 
structures called windows which can be thought of as two 
dimensional arrays of characters representing all or part 
of a CRT screen. A default window called stdscr is 
supplied, and others can be created with newwin. 
Windows are referred to by variables declared ““WINDOW 
*” the type WINDOW is defined in curses.h to be a C 
structure. These data structures are manipulated with 
functions described below, among which the most basic 
are move, and addch. (More general versions of these 
functions are included with names beginning with ‘w’, 
allowing you to specify a window. The routines not 
beginning with ‘w’ affect stdser.) Then refresh() is 
called, telling the routines to make the users CRT screen 
look like stdser. 


Mini-Curses is a subset of curses which does not allow 
manipulation of more than one window. To invoke this 
subset, use -DMINICURSES as a ce option. This level is 
smaller and faster than full curses. 


If the environment variable TERMINFO is defined, any 
program using curses will check for a local terminal 
definition before checking in the standard place. For 
example, if the standard place is /usr/lib/terminfo, 
and TERM is set to ‘“‘vt100’’, then normally the compiled 
file is found in /usr/lib/terminfo/v/vt100. (The ‘“‘v” 
is copied from the first letter of “vt100”" to avoid 
creation of huge directories.) However, if TERMINFO is 
set to /usr/mark/myterms, curses will first check 
/usr/mark/myterms/v/vt100, and if that fails, will 
then check /usr/lib/terminfo/v/vt100. This is 
useful for developing experimental definitions or when 
write permission in /usr/lib/terminfo is not available. 
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SEE ALSO 
terminfo(4). 

FUNCTIONS 
Routines listed here may be called when using the full 
curses. Those marked with an asterisk may be called 
when using Mini-Curses. 


addch(ch)* add a character to stdscr (like putchar) 
(wraps to next line at end of line) 

addstr(str)* calls addch with each character in str 

attroff: ae turn off attributes named 

attron(attrs)* turn on attributes named 


attrset(attrs)* set current attributes to attrs 

baudrate( )* current terminal speed 

beep( )* sound beep on terminal 

box(win, vert, noe) 
raw a box around edges of win vert 

and hor are chars to use for vert. and 

hor. edges of box 


cleat) clear stdser 

clearok(win, bf) clear screen before next redraw of win 
elrtobot( ) clear to bottom of stdser 

clrtoeol( ) clear to end of line on stdser 

cbreak( )* set cbreak mode 


delay_output(ms)* 


insert ms millisecond pause in output 


delch( ) delete a character 

deleteln( ) delete a line 

delwin(win delete win 

doupdate( update screen from all wnooutrefresh 

echo( )* set echo mode 

endwin( )* end window modes 

erase( ) erase stdscr 

erasechar{ ) return user’s erase character 

fixterm( ) restore tty to "in curses” state 

flash( ) flash screen or beep 

flushinp( )* throw away any typeahead 

getch( ye get a char from tty 

getstr(str) get a string through stdscr 

gettmode( ) establish current tty modes 

getyx(win, y, x) get (y, x) co-ordinates 

has_ic( true if terminal can do insert character 

has_il( ) true if terminal can do insert line 

idlok(win, bf)* use terminal’s insert/delete line if bf != 
0 

inch( ) get char at current (y, x) co-ordinates 

initscr( )* initialize screens 

insch(c) insert a char 


' 
Le) 
' 
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insertln( insert a line 

intrflush(win, bf) 

interrupts flush output if bf is TRUE 

keypad(win, bf) enable keypad input 

killchar( ) return current user’s kill character 

leaveok(win, flag) 

OK to leave cursor anywhere after 
refresh if flag!=0O for win, otherwise 
cursor must be left at current position. 

fonenamast ) ) return verbose name of terminal 

ag 


meta(win, * allow meta characters on input if flag 
= 0 
move(y, x)* move to (y, x) on atdser 


mvaddch(y, x, ch) 
move(y, x) then addch(ch) 
mvaddstr(y, x, str) 
similar... 
mvcur(oldrow, oldcol, newrow, newcol) 
low level cursor motion 
eget 3 like delch, but move(y, x) first 
mvgetch etc. 
mv¢getstr' 
mvinch(y, x 
mvinsch(y, ‘ 
mvprintw(y, x, fmt, args) 
mvscanw(y, x, fmt, args 
mvwaddc (win, y, x, 5 
mvwaddstr(win, y, x, str) 
mvwdelch(win, y, x 
mvwgetch(win, y, x 
mvwegetstr(win, y, x 
mvwin(win, by, bx 
mvwinch(win, y, x 
mvwinsch(win, y, x, c) 
mvwprintw(win, y, x, fmt, args) 
mvwscanw(win, y, x, fmt, args) 
newpad(nlines, ncols) 
create a new pad with given dimensions 
newterm(type, fd) 
set up new terminal of given type to 
output on fd 
newwin(lines, cols, begin_y, begin_x) 
create a new window 
ni( i" set newline mapping 
nocbreak( )* unset cbreak mode 
nodelay(win, bf) enable nodelay input mode through 
getch 
noecho( )* unset echo mode 
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nonl( )* unset newline mapping 
noraw( )* unset raw mode 
overlay(winl, win2) 


overlay winl on win2 
overwrite(winl, win2) 
overwrite winl on top of win2 
pnoutrefresh(pad, pminrow, pmincol, sminrow, 
smincol, smaxrow, smaxcol) 
like prefresh but with no output until 
doupdate called 
prefresh(pad, pminrow, pmincol, sminrow, 
smincol, smaxrow, smaxcol) 
refresh from pad starting with given 
upper left corner of pad with output to 
given portion of screen 
printw(fmt, argl, arg2, ...) 
printf on stdser 


raw( )* set raw mode 

refresh( )* make current screen look like stdscr 
resetterm( )* — set tty modes to "out of curses” state 
resetty( )* reset tty flags to stored value 


saveterm( )* 
save current modes as "in curses” state 
savetty( )* 
store current tty flags 
scanw(fmt, argl, arg2, ...) 
scanf through stdser 
scroll(win) scroll win one line 
scrollok(win, flag) 
allow terminal to scroll if flag !== 0 
set_term(new) now talk to terminal new 
setscrreg(t, b) set user scrolling region to lines t 
through b 
setterm(type) | establish terminal with given type 
setupterm term, filenum, errret) 
standend( )* clear standout mode attribute 
standout( )* set standout mode attribute 
subwin(win, lines, cols, begin_y, begin_x) 
create a subwindow 
touchwin(win) change all of win 
traceoff turn off debugging trace output 
traceon turn on debugging trace output 
typeahead(fd) use file descriptor fd to check 
typeahead 
unctrl(ch)* printable version of ch 
waddch(win, ch) add char to win 
waddstr(win, str) 
add string to win 
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wattroff(win, attrs) 

turn off afirs in win 
wattron(win, attrs) 

turn on attrs in win 
wattrset(win, attrs) 

set attrs in win to attre 
welear(win) clear win 
welrtobot(win) clear to bottom of win 
welrtoeol(win) clear to end of line on win 
wdelch(win, c) delete char from win 


wdeleteln(win) delete line from win 
werase(win) erase win 

wgetch(win) get a char through win 
wegetstr(win, str) get a string through win 
winch(win) get char at current (y, x) in win 


econ, c) insert char into win 
winsertln(win) insert line into win 
wmove(win, y, x) 

set current (y, x) co-ordinates on win 
wnoutrefresh(win) 

refresh but no screen output 
wprintw(win, fmt, argl, arg2, ...) 

printf on win 
wrefresh(win) make screen look like win 
wscanw(win, fmt, argl, arg2, ...) 

scanf through win 
wsetscrreg(win, t, b) 

set scrolling region of win 
wstandend(win) 

clear standout attribute in win 
wstandout(win) set standout attribute in win 


TERMINFO LEVEL ROUTINES 
These routines should be called by programs wishing to 
deal directly with the terminfo database. Due to the low 
level of this interface, it is discouraged. Initially, 
setupterm should be called. This will define the set of 
terminal dependent variables defined in terminfo(4). 
The include files <curses.h> and <term.h> should be 
included to get the definitions for these strings, numbers, 
and flags. Parmeterized strings should be passed 
through tparm to instantiate them. All terminfo strings 
(including the output of tparm) should be printed with 
tputs or putp . Before exiting, resetterm should be called 
to restore the tty modes. (Programs desiring shell 
escapes or suspending with control Z can call resetterm 


before the shell is called and fizterm after returning from 
the shell.) 
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fixterm( ) restore tty modes for terminfo use 
(called by setupterm) 

resetterm( ) reset tty modes to state before program 
entry 


setupterm(term, fd, rc) 

read in database. Terminal type is the 
character string term, all output is to 
CTIX file descriptor fd. A status value 
is returned in the integer pointed to by 
re: 1 is normal. The simplest call 
would be setupterm(0, 1, 0) which uses 
all defaults. 


tparm(str, pl, p2, ..., p9) 
instantiate string str with parms P.- 


tputs(str, affent, putc) 
apply padding info to string str. affcent 
is the number of lines affected, or 1 if 
not applicable. Putc is a putchar-like 
function to which the characters are 
passed, one at a time. 


putp(str) handy function that calls tputs (str, 1, 
putchar) 


vidputs(attrs, putc) 
output the string to put terminal in 
video attribute mode attrs, which is any 
combination of the attributes listed 
below. Chars are passed to putchar-like 
function pute. 


vidattr(attrs) Like vidputs but outputs through 
putchar 


TERMCAP COMPATIBILITY ROUTINES 
These routines were included as a conversion aid for 
programs that use termcap. Their parameters are the 
same as for termcap. They are emulated using the 
terminfo database. They may go away at a later date. 


tgetent(bp, a 
ook up termcap entry for name 


tgetflag(id) get boolean entry for id 
tgetnum(id) get numeric entry for id 
tgetstr(id, area) get string entry for id 


tgoto(cap, col, row) 
apply parms to given cap 
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tputs(cap, affcnt, fn) 
apply padding to cap calling fn as 
putchar 


ws ATTRIBUTES 


The following video attributes can be passed to the 
functions attron ,attroff,atirset. 


A_STANDOUT Terminal’s best highlighting mode 


A_UNDERLINE 

Underlining 
A_REVERSE _ Reverse video 
A_BLINK Blinking 
A_DIM Half bright 
A_BOLD Extra bright or bold 


A_ALTCHARSET 
Alternate character set 


FUNCTION KEYS 


The following function keys might be returned by getch 
if keypad has been enabled. Note that not all of these 
are currently supported, due to lack of definitions in 
terminfo or the terminal not transmitting a unique code 


om when the key is pressed. 
KEY_BREAK 0401 break key (unreliable) 
KEY_DOWN 0402 The four arrow keys ... 
KEY_UP 0403 
KEY_LEFT 0404 
KEY_RIGHT 0405 
KEY_HOME 0406 Home key (upward+left arrow) 


KEY_BACKSPACE 


KEY_FO 
KEY_F(n) 


KEY_DL 
KEY_IL 
am KEY_DC 
KEY_IC 
KEY_EIC 


0410 


(KEY_F0+(n) 


0510 
0511 
0512 
0513 
0514 


0407 
backspace (unreliable) 


Function keys. Space for 64 is 
reserved. 


Formula for fn. 

Delete line 

Insert line 

Delete character 

Insert char or enter insert mode 


Exit insert char mode 
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KEY_CLEAR 0515 
KEY_EOS 0516 
KEY_EOL 0517 
KEY_SF 0520 
KEY_SR 0521 
KEY_NPAGE 0522 
KEY_PPAGE 0523 
KEY_STAB = 0524 
KEY_CTAB 0525 
KEY_CATAB 0526 
KEY_ENTER 0527 
KEY_SRESET 0530 
KEY_RESET 0531 
KEY_PRINT 0532 
KEY_LL 0533 
WARNING 


Clear screen 

Clear to end of screen 

Clear to end of line 

Scroll 1 line forward 

Scroll 1 line backwards (reverse) 
Next page 

Previous page 

Set tab 

Clear tab 

Clear all tabs 

Enter or send (unreliable) 

soft (partial) reset (unreliable) 
reset or hard reset (unreliable) 
print or copy 

home down or bottom (lower left) 


The plotting library plot(3X) and the curses library 
curses(3X) both use the names erase( ) and move( ). The 
curses versions are macros. If you need both libraries, 
put the plot(3X) code in a different source file than the 
curses(3X) code, and/or #undef move( ) and erase( ) in 


the plot(3X) code. 


CUSERID ( 3S ) 


cuserid — get character login name of the user 


SYNOPSIS 


#include <stdio.h> 


char *cuserid (s) 
char *s; 


DESCRIPTION 


Cuserid gets the user’s login name as found in 
/etc/utmp. If the login name cannot be found, cuserid 
gets the login name corresponding to the user ID of the 
process. If s is a NULL pointer, this representation is 
generated in an internal static area, the address of which 
is returned. Otherwise, ¢ is assumed to point to an 
array of at least L_cuserid characters; the 
representation is left in this array. The constant 
L_cuserid is defined in the <stdio.h> header file. 


DIAGNOSTICS 


If the login name cannot be found, cusertd returns a 
NULL pointer; if s is not a NULL pointer, a null 
character (\0) will be placed at s/0/. 


SEE ALSO 


getlogin(3C), getpwent(3C). 


NAME 


DIAL(3C) 


dial — establish an out-going terminal line connection 


SYNOPSIS 


#include <dial.h> 


int dial (call) 
CALL “call; 


void undial (fd) 
int fd; 


DESCRIPTION 


5/86 


Dial returns a file-descriptor for a terminal line open for 
read/write. The argument to dtal is a CALL structure 
(defined in the <dial.h> header file). 


When finished with the terminal line, the calling 
program must invoke undtal to release the semaphore 
that has been set during the allocation of the terminal 
device. 


The definition of CALL in the <dial.-h> header file is: 


typedef struct { 
struct termio *attr; 
Fé * pointer to termio attribute struct */ 
int baud; 
/* transmission data rate */ 
int speed; 
/* 212A modem: low—300, high—1200 
(unused) */ 
char *line; 
/* device name for out-going line */ 
char *telno; 
/* pointer to tel-no digits string */ 
int modem; 
/* specify modem control for direct lines */ 
char *device; 
/* Will hold the name of the device used 
to make a connection (unused) */ 
int dev_len; 
/* The length of the device used to 
make connection (unused) */ 
} CALL; 


The CALL element baud is for the desired transmission 
baud rate. The rate must be one of those supported by 
the operating system (134.5 is rounded to 134). If the 
baud is less than 300, the line will be dialed at 300 baud 
then switched to the desired rate (unless attr is non-null; 
see below). 


FILES 
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If a particular terminal line is desired, a string pointer to 
its device-name should be placed in the line element in 
the CALL structure. Legal values for such terminal 
device names are kept in /usr/lib/uucp/Devices. In 
this case, if baud is 0, the speed used will be determined 
by the line in the Devices file for the terminal device. 


The telno element is for a pointer to a character string 
representing the telephone number to be dialed. 
Numbers consist of the following symbols: 


0-9 dial 0-9 
dial * 
dial ## 


4-second delay for second dial tone 
wait for secondary dial tone 


On a smart modem, these symbols are translated to 
modem commands using the modem description in 
/usr/lib/uucp/Dialers. 

If telno is specified, an ACU entry in the Devices file 
will be used. If it is NULL, a Direct entry will be used. 


The CALL element modem is used to specify modem 
control for direct lines. This element should be non-zero 
if modem control is required. 


| tae * 


The CALL element atir is a pointer to a termio 
structure, as defined in the termio.h header file. A NULL 
value for this pointer element may be passed to the dial 
function, but if such a structure is included, the elements 
specified in it will be set for the outgoing terminal line 
before the connection is established. This is often 
important for certain attributes such as parity and 
baud-rate. Values in this structure override the baud and 
modem entries. 


Information on 801 type dialing units is obtained from 
the Devices file; thus the speed, device and dev_len 
elements are no longer used. 


/usr/lib/uucp/Devices 
/usr/lib/uucp/Dialers 
/usr/spool/locks/LCK.. tty-device 


SEE ALSO 


uucp(iC), alarm(2), read(2), write(2),  Devices(5), 
Dialers(5), termio(7). 


DIAGNOSTICS 
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On failure, dial will return -1 and the external variable 
Uerror will contain one of the error codes defined in the 
<dial.h> header file. 


-2- 
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If the external variable Debug is set to a number between 
1 and 9, information about the progress of the call will 
be printed on the standard output. 


5/86 Ke 


DRAND48(3C) 


NAME 
drand48, erand48, lrand48, nrand48, mrand48, jrand48, 
srand48, seed48, Icong48 -— _ generate uniformly 
distributed pseudo-random numbers 

SYNOPSIS 


double drand48 ( ) 


double erand48 (xsubi 
unsigned short xsubi[3}; 


long Irand48 ( ) 


long nrand48 (xsubi) 
unsigned short xsubi(3]; 


long mrand48 ( ) 


long jrand48 (xsubi) 
unsigned short xsubi(3]; 


void srand48 (seedval) 
long seedval; 


unsigned short *seed48 (seed16v) 
unsigned short seed16v/[3]; 


void lecong48 (param) 
unsigned short param(7]; 


DESCRIPTION 
This family of functions generates pseudo-random 
numbers using the well-known linear congruential 
algorithm and 48-bit integer arithmetic. 


Functions drand48 and erand48 return non-negative 
double-precision floating-point values uniformly 
distributed over the interval (0.0, 1.0). 


Functions Irand48 and nrand48 return non-negative long 
integers uniformly distributed over the interval (0, 2°’). 


Functions mrand48 and jrand48 return signed long 
ie eo uniformly distributed over the interval 
Functions srand48, seed48 and Icong48 are initialization 
entry points, one of which should be invoked before 
either drand48, lrand48 or mrand48 is called. (Although 
it is not recommended practice, constant default 
initializer values will be supplied automatically if 
drand48, lrand48 or mrand48 is called without a prior 
call to an initialization entry point.) Functions erand48, 
nrand48 and jrand48 do not require an_ initialization 
entry point to be called first. 


All the routines work by generating a sequence of 48-bit 
integer values, X;, according to the linear congruential 


Pes 
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formula 
Xn = (aX, +e Vasad m n >0. 


The parameter m = 2"; hence 48-bit integer arithmetic 
is performed. Unless Icong48 has been invoked, the 
multiplier value @ and the addend value ¢ are given by 


a = 5DEECEE6ED 14 = 273673163155 
c =B 16 13 8: 


The value returned by any of the functions drand48, 
erand48, lrand48, nrand48, mrand48 or jrand48 is 
computed by first generating the next 48-bit X; in the 
sequence. Then the appropriate number of bits, 
according to the type of data item to be returned, are 
copied from the high-order (leftmost) bits of X; and 
transformed into the returned value. 


The functions drand48, lrand48 and mrand48 store the 
last 48-bit X; generated in an internal buffer; that is 
why they must be initialized prior to being invoked. 
The functions erand48, nrand48 and jrand48 require the 
calling program to provide storage for the successive X; 
values in the array specified as an argument when the 
functions are invoked. That is why these routines do not 
have to be initialized; the calling program merely has to 
place the desired initial value of X; into the array and 
pass it as an argument. By using different arguments, 
functions erand48, nrand48 and jrand48 allow separate 
modules of a large program to. generate several 
independent streams of pseudo-random numbers, i.e., the 
sequence of numbers in each stream will not depend 
upon how many times the routines have been called to 
generate numbers for the other streams. 


The initializer function srand4{8 sets the high-order 32 
bits of X; to the 32 bits contained in its argument. The 
low-order 16 bits of X; are set to the arbitrary value 
330E ie. 


The initializer function seed48 sets the value of X; to 
the 48-bit value specified in the argument array. In 
addition, the previous value of X; is copied into a 48-bit 
internal buffer, used only by seed48, and a pointer to 
this buffer is the value returned by seed48. This 
returned pointer, which can just be ignored if not 
needed, is useful if a program is to be restarted from a 
given point at some future time — use the pointer to get 
at and store the last X; value, and then use this value to 
reinitialize via seed48 when the program is restarted. 


The initialization function lfcong48 allows the user to 
specify the initial X;, the multiplier value @, and the 
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addend value c. Argument array elements param/0-2/ 
specify X;, param/$-5] specify the multiplier a, and 
param/6/ specifies the 16-bit addend c. After lcong48 
has been called, a subsequent call to either srand48 or 
seed48 will restore the “standard” multiplier and addend 
values, a and ¢, specified on the previous page. 


SEE ALSO 
rand(3C). 


ECVT(3C) 


NAME 
ecvt, fevt, gevt — convert floating-point number to string 

SYNOPSIS 
char *ecvt (value, ndigit, decpt, sign) 
double value; 
int ndigit, *decpt, *sign; 
char *fcvt (value, ndigit, decpt, sign) 
double value; 
int ndigit, *decpt, *sign; 
char *gcevt (value, ndigit, buf) 
double value; 
int ndigit; 
char *buf; 

DESCRIPTION 
Ecvt converts value to a null-terminated string of ndigit 
digits and returns a pointer thereto. The high-order 
digit is non-zero, unless the value is zero. The low-order 
digit is rounded. The position of the decimal point 
relative to the beginning of the string is stored indirectly 
through decpt (negative means to the left of the returned 
digits). The decimal point is not included in the returned 
string. If the sign of the result is negative, the word 
pointed to by stgn is non-zero, otherwise it is zero. 
Fevt is identical to ecvt, except that the correct digit has 
been rounded for printf deen (FORTRAN F-format) 
output of the number of digits specified by ndigzt. 
Gevt converts the value to a null-terminated string in 
the array pointed to by buf and returns buf. It attempts 
to produce ndtgtt significant digits in FORTRAN F- 
format if possible, otherwise E-format, ready for 
printing. A minus sign, if there is one, or a decimal point 
will be included as part of the returned string. Trailing 
zeros are suppressed. 

SEE ALSO 
printf(3S). 

BUGS 


The values returned by ecvt and fevt point to a single 
static data array whose content is overwritten by each 
call. 


” 7 


NAME 


END (3C) 


end, etext, edata — last locations in program 


SYNOPSIS 


extern end; 
extern etext; 
extern edata; 


DESCRIPTION 


These names refer neither to routines nor to locations 
with interesting contents. The address of efext is the 
first address above the program text, edata above the 
initialized data region, and end above the uninitialized 
data region. 


When execution begins, the program break (the first 
location beyond the data) coincides with end, but the 
program break may be reset by the routines of brk(2), 
malloc(3C), standard input/output (stdto(3S)), the 
profile (—p) option of ec(1), and so on. Thus, the 
current value of the program break should be determined 


by sbrk(0) (see brk(2)). 


SEE ALSO 


brk(2), malloc(3C), stdio(3S). 


ERF (3M) 


NAME 
erf, erfc ~— error function and complementary error 
function 

SYNOPSIS 


#include <math.h> 
double erf (x) 
double x; 

double erfe (x) 
double x; 


DESCRIPTION 
Erf returns the error function of z, defined as 


safe ~ ade. 

T 0 

Erfe, which returns 1.0 — erf(z), is provided because of 
the extreme loss of relative accuracy if ay is called for 


large z and the result subtracted from 1.0 (e.g., for 7 = 
5, 12 places are lost). 


SEE ALSO 
exp(3M). 


EXP (3M) 


NAME 
exp, log, logl10, pow, sqrt - exponential, logarithm, 
power, square root functions 
~~ SYNOPSIS 
#include <math.h> 


double exp (x) 
double x; 


double log (x) 
double x; 


double log10 (x) 
double x; 


double pow (x, y) 
double x, y; 


double sqrt (x) 
double x; 


DESCRIPTION 
Ezp returns e’. 


Log returns the natural logarithm of z. The value of z 
must be positive. 


Log10 returns the logarithm base ten of z. The value of 
a z must be positive. 


Pow returns x’. If z is zero, y must be positive. If x is 
negative, y must be an integer. 


Sqrt returns the non-negative square root of r. The 
value of z may not be negative. 


DIAGNOSTICS 
Exp returns HUGE when the correct value would 
overflow, or 0 when the correct value would underflow, 
and sets errno to ERANGE. 


Log and logi0 return -HUGE and set errno to EDOM 
when z is non-positive. A message indicating DOMAIN 
error (or SING error when z is 0) is printed on the 
standard error output. 


Pow returns 0 and sets errno to EDOM when z is 0 and 
y is non-positive, or when z is negative and y is not an 
integer. In these cases a message indicating DOMAIN 
error is printed on the standard error output. When the 
correct value for pow would overflow or underflow, pow 
returns +HUGE or 0 respectively, and sets errno to 
ERANGE. 


Sqrt returns 0 and sets errno to EDOM when 1 is 
negative. A message indicating DOMAIN error is printed 
on the standard error output. 


a fis 
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These error-handling procedures may be changed with 
the function matherr(3M). 


SEE ALSO 
hypot(3M), matherr(3M), sinh(3M). 


FCLOSE(3S) 


NAME 
fclose, fflush — close or flush a stream 
SYNOPSIS 
#include <stdio.h> 
int fclose (stream) 
FILE *stream; 
int fflush (stream) 
FILE *stream; 
DESCRIPTION 
Felose causes any buffered data for the named stream to 
be written out, and the stream to be closed. 
Felose is performed automatically for all open files upon 
calling extt(2). 
Fflush causes any buffered data for the named stream to 
be written to that file. The stream remains open. 
DIAGNOSTICS 
These functions return 0 for success, and EOF if any 
error (such as trying to write to a file that has not been 
opened for writing) was detected. 


SEE ALSO 
close(2), exit(2), fopen(3S), setbuf(3S). 


NAME 


FERROR (3S) 


ferror, feof, clearerr, fileno — stream status inquiries 


SYNOPSIS 


#include <stdio.h> 


int ferror (stream) 
FILE *stream; 


int feof (stream) 
FILE *stream; 


void clearerr (stream) 
FILE *stream; 


int fileno (stream) 
FILE *stream; 


DESCRIPTION 


NOTE 


Ferror returns non-zero when an I/O error has 
previously occurred reading from or writing to the 
named stream, otherwise zero. 


Feof returns non-zero when EOF has previously been 
detected reading the named input stream, otherwise 
zero. 


Clearerr resets the error indicator and EOF indicator to 
zero on the named stream. 


Fileno returns the integer file descriptor associated with 
the named stream; see open(2). 


All these functions are implemented as macros; they 
cannot be declared or redeclared. 


SEE ALSO 


open(2), fopen(3S). 


-_ 


NAME 


FLOOR(3M) 


floor, ceil, fmod, fabs - floor, ceiling, remainder, 
absolute value functions 


SYNOPSIS 


#include <math.h> 
double floor (x) 
double x; 

double ceil (x) 
double x; 

double fmod (x, y) 
double x, y; 


double fabs (x) 


double x; 


DESCRIPTION 


Floor returns the largest integer (as a double-precision 
number) not greater than z. 


Ceil returns the smallest integer not less than z. 


Fmod returns the floating-point remainder of the 

division of x by y: zero if y is zero or if z/y would 

overflow; otherwise the number f with the same sign as 

if i that z = ty + f for some integer 1, and |f| < 
y 

Fabs returns the absolute value of z, | z |. 


SEE ALSO 


abs(3C). 


FOPEN(3S) 


NAME 
fopen, freopen, fdopen — open a stream 
SYNOPSIS 
#include <stdio.h> 
FILE *fopen (file-name, type) 
char *file-name, *type; 
FILE *freopen (file-name, type, stream) 
char *file-name, *type; 
FILE *stream; 
FILE *fdopen (fildes, type) 
int fildes; 
char *type; 
DESCRIPTION 
Fopen opens the file named by ftle-name and associates 
a stream with it. Fopen returns a pointer to the FILE 
structure associated with the stream. 


File-name points to a character string that contains the 
name of the file to be opened. 


Type is a character string having one of the following 


values: 

"rn open for reading 

"w" truncate or create for writing 

"ar append; open for writing at end of 
file, or create for writing 

"ry open for update (reading and writing) 

"w+" truncate or create for update 

"at" append; open or create for update at 
end-of-file 


Freopen substitutes the named file in place of the open 
stream. The original stream is closed, regardless of 
whether the open ultimately succeeds. Freopen returns 
a pointer to the FILE structure associated with stream. 


Freopen is typically used to attach the preopened 
streams associated with stdin, stdout and stderr to 
other files. 


Fdopen associates a stream with a file descriptor. File 
descriptors are obtained from open(2), dup(2), creat(2), 
or pipe(2), which open files but not return pointers to a 
FILE structure stream. Streams are necessary arguments 
for many of the section 35 library routines. The type of 
stream must agree with the mode of the open file. 
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When a file is opened for update, both input and output 
may be done on the resulting stream. However, output 
may not be directly followed by input without an 
intervening fseek or rewind, and input may not be 
directly followed by output without an intervening fseek, 
rewind, or an input operation which encounters end-of- 
file. 


When a file is opened for append (i.e., when type is ”a” 
or "at+”), it is impossible to overwrite information 
already in the file. Fseek may be used to reposition the 
file pointer to any position in the file, but when output is 
written to the file, the current file pointer is disregarded. 
All output is written at the end of the file and causes the 
file pointer to be repositioned at the end of the output. 
If two separate processes open the same file for append, 
each process may write freely to the file without fear of 
destroying output being written by the other. The 
output from the two processes will be intermixed in the 
file in the order in which it is written. 


SEE ALSO 
creat(2), dup(2), open(2), pipe(2), fclose(3S), fseek(3S). 


DIAGNOSTICS 
Fopen and freopen return a NULL pointer on failure. 


FREAD (3S) 


NAME 
fread, fwrite — binary input/output 


SYNOPSIS 
#iinclude <stdio.h> 


int fread (ptr, size, nitems, stream) 
char *ptr; 

int size, nitems; 

FILE *stream; 


int fwrite (ptr, size, nitems, stream) 
char *ptr; 

int size, nitems; 

FILE *stream; 


DESCRIPTION 

Fread copies, into an array pointed to by pir, nitems 
items of data from the named input stream, where an 
item of data is a sequence of bytes (not necessarily 
terminated by a null byte) of length size. Fread stops 
appending bytes if an end-of-file or error condition is 
encountered while reading stream, or if nitems items 
have been read. Frread leaves the file pointer in stream, 
if defined, pointing to the byte following the last byte 
read if there is one. Fread does not change the contents 
of stream. 


Fwrite appends at most nitems items of data from the 
array pointed to by pétr to the named output stream. 
Fwrtte stops appending when it has appended nitems 
items of data or if an error condition is encountered on 
stream. Fwrite does not change the contents of the 
array pointed to by ptr. 


The argument size is typically stzeof(*ptr) where the 
pseudo-function stzeof specifies the length of an item 
pointed to by pér. If ptr points to a data type other 
than char it should be cast into a pointer to char. 

SEE ALSO 
read(2), write(2), fopen(3S), gete(3S), gets(3S), printf(3S), 
putc(3S), puts(3S), scanf(3S). 

DIAGNOSTICS 
Fread and fwrtte return the number of items read or 
written. If stze or nitems is non-positive, no characters 
are read or written and 0 is returned by both fread and 
fwrite. 
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NAME 


FREXP (3C) 


frexp, ldexp, modf — manipulate parts of floating-point 
numbers 


SYNOPSIS 


double frexp (value, eptr) 
double value; 
int *eptr; 


double Idexp (value, exp) 
double value; 
int exp; 


double modf (value, iptr) 
double value, *iptr; 


DESCRIPTION 


Every non-zero number can be written uniquely as x * 
2”, where the “‘mantissa” (fraction) z is in the range 0.5 
< |z| < 1.0, and the “exponent” n is an integer. 
Frezp returns the mantissa of a double value, and stores 
the exponent indirectly in the location pointed to by 
eptr. If value is zero, both results returned by frezp are 
zero. 


Ldezp returns the quantity value * 2°7?. 


Modf returns the signed fractional part of value and 
stores the integral part indirectly in the location pointed 
to by tptr. 


DIAGNOSTICS 


If ldezp would cause overflow, +HUGE is returned 
(according to the sign of value), and errno is set to 
ERANGE. 

If ldezp would cause underflow, zero is returned and 
errno is set to ERANGE. 
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NAME 
fseek, rewind, ftell — reposition a file pointer in a stream 


SYNOPSIS 
#include <stdio.h> 


int fseek (stream, offset, ptrname) 
FILE *stream; 

long offset; 

int ptrname; 


void rewind (stream) 
FILE *stream; 


long ftell (stream) 
FILE *stream; 


DESCRIPTION 
Feseek sets the position of the next input or output 
operation on the stream. The new position is at the 
signed distance offset bytes from the beginning, from the 
current position, or from the end of the file, according as 
ptrname has the value 0, 1, or 2. 


Rewind(stream) is equivalent to feeek(stream, OL, 0), 
except that no value is returned. 


Feseek and rewind undo any effects of ungete(3S). 


After feeek or rewind, the next operation on a file 
opened for update may be either input or output. 


Ftell returns the offset of the current byte relative to the 
beginning of the file associated with the named stream. 


SEE ALSO 
Iseek(2), fopen(3S) popen(3S), ungetc(3S). 

DIAGNOSTICS 
Fseek returns non-zero for improper seeks, otherwise 
zero. An improper seek can be, for example, an fseek 
done on a file that has not been opened via fopen; in 
particular, feeek may not be used on a terminal, or on a 
file opened via popen(38S). 

WARNING 
Although on the CTIX and other systems derived from 
the UNIX system, an offset returned by ftell is measured 
in bytes, and it is permissible to seek to positions relative 
to that offset, portability to non-UNIX systems requires 
that an offset be used by fseek directly. Arithmetic may 
not meaningfully be performed on such an offset, which 
is not necessarily measured in bytes. 
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ftw — walk a file tree 


SYNOPSIS 


#include <ftw.h> 

int ftw (path, fn, depth) 
char *path; 

int (*fn) ( ); 

int depth; 


DESCRIPTION 


Ftw recursively descends the directory hierarchy rooted 
in path. For each object in the hierarchy, ftw calls fn, 
passing it a pointer to a null-terminated character string 
containing the name of the object, a pointer to a stat 
structure (see stat(2)) containing information about the 
object, and an integer. Possible values of the integer, 
defined in the <ftw.h> header file, are FTW_F for a 
file, FTW_D for a directory, FTW_DNR for a directory 
that cannot be read, and FTW_NS for an object for 
which stat could not successfully be executed. If the 
integer is FTW_DNR, descendants of that directory will 
not be processed. If the integer is FTW_NS, the stat 
structure will contain garbage. An example of an object 
that would cause FTW_NS to be passed to fn would be a 
file in a directory with read but without execute (search) 
permission. 


Ftw visits a directory before visiting any of its 
descendants. 


The tree traversal continues until the tree is exhausted, 
an invocation of fn returns a nonzero value, or some 
error is detected within ftw (such as an I/O error). If 
the tree is exhausted, ftw returns zero. If fn returns a 
nonzero value, ftw stops its tree traversal and returns 
whatever value was returned by fn. If ftw detects an 
error, it returns —1, and sets the error type in errno. 


Ftw uses one file descriptor for each level in the tree. 
The depth argument limits the number of file descriptors 
so used. If depth is zero or negative, the effect is the 
same as if it were 1. Depth must not be greater than the 
number of file descriptors currently available for use. 
Ftw will run more quickly if depth is at least as large as 
the number of levels in the tree. 


SEE ALSO 


stat(2), malloc(3C). 


BUGS 
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Because ftw is recursive, it is possible for it to terminate 
with a memory fault when applied to very deep file 
structures. 

It could be made to run faster and use less storage on 
deep structures at the cost of considerable complexity. 
Ftw uses malloc(3C) to allocate dynamic storage during 
its operation. If ftw is forcibly terminated, such as by 
longymp being executed by fn or an interrupt routine, 
ftw will not have a chance to free that storage, so it will 
remain permanently allocated. A safe way to handle 
interrupts is to store the fact that an interrupt has 
occurred, and arrange to have fn return a nonzero value 
at its next invocation. 


GAMMA(3M) 


NAME 
gamma — log gamma function 
SYNOPSIS 
#include <math.h> 
double gamma (x) 
double x; 
extern int signgam; 


DESCRIPTION 
Gamma returns In( | T(z) |), where I'( 2) is defined as 


fe-tt?-'dt. The sign of T(z) is returned in the 
0 


external integer signgam. The argument z may not be a 
non-positive integer. 
The following C program fragment might be used to 
calculate Pr: 

if ((y = gamma(x)) > LN_MAXDOUBLE) 

error( ); 

y = signgam * exp(y); 
where LN_MAXDOUBLE is the least value that causes 
ezp(3M) to return a range error, and is defined in the 
<values.h> header file. 

DIAGNOSTICS 

For non-negative integer arguments HUGE is returned, 
and errno is set to EDOM. A message indicating SING 
error is printed on the standard error output. 


If the correct value would overflow, gamma returns 
HUGE and sets errno to ERANGE. 


These error-handling procedures may be changed with 
the function matherr(3M). 


SEE ALSO 
exp(3M), matherr(3M), values(5). 


GETC(3S) 


NAME 
getc, getchar, fgetc, getw — get character or word from a 
stream 


SYNOPSIS 
#tinclude <stdio.h> 


int gete (stream) 
FILE *stream; 


int getchar () 


int fgetc (stream) 
FILE *stream; 


int getw (stream) 
FILE *stream; 


DESCRIPTION 
Gete returns the next character (i.e., byte) from the 
named input stream, as an integer. It also moves the 
file pointer, if defined, ahead one character in stream. 
Getchar is defined as getc(stdin). Gete and getchar are 
macros. 


Fgetce behaves like getc, but is a function rather than a 
macro. Fgete runs more slowly than getc, but it takes 
less space per invocation and its name can be passed as 
an argument to a function. 


Getw returns the next word (i.e., integer) from the 
named input stream. Getw increments the associated 
file pointer, if defined, to point to the next word. The 
size of a word is the size of an integer and varies from 
machine to machine. Getw assumes no_ special 
alignment in the file. 


SEE ALSO 
fclose(3S), ferror(3S), fopen(3S), fread(3S), gets(3S), 
putc(3S), scanf(3S 


DIAGNOSTICS 
These functions return the constant EOF at end-of-file 
or upon an error. Because EOF is a valid integer, 
ferror(3S) should be used to detect getw errors. 


WARNING 
If the integer value returned by getc, getchar, or fgetc is 
stored into a character variable and then compared 
against the integer constant EOF, the comparison may 
never succeed, because sign-extension of a character on 
widening to integer is machine-dependent. 


BUGS 
Because it is implemented as a macro, gete treats 
incorrectly a stream argument with side effects. In 
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particular, getce(*f++) does not work sensibly. Fyetc 
should be used instead. 

Because of possible differences in word length and byte 
ordering, files written using pufw are machine- 


dependent, and may not be read using getw on a 
different processor. 


GETCWD(3C) 


NAME 
getewd — get path-name of current working directory 


SYNOPSIS 
char *getewd (buf, size) 
char *buf; 
int size; 

DESCRIPTION 
Getcwd returns a pointer to the current directory path- 
name. The value of stze must be at least two greater 
than the length of the path-name to be returned. 


If buf is a NULL pointer, getewd will obtain size bytes of 
space using malloc(3C). In this case, the pointer 
returned by getcwd may be used as the argument in a 
subsequent call to free. 


The function is implemented by using popen(3S) to pipe 
the output of the pwd(1) command into the specified 
string space. 

EXAMPLE 
char *cwd, *getcwd(); 


if ((ewd = getewd((char *)NULL, 64)) == NULL) { 
perror(“pwd’’); 
exit(1); 
printf{(“%s\n”, cwd); 
SEE ALSO 
pwd(1), malloc(3C), popen(3S). 
DIAGNOSTICS 


Returns NULL with errno set if size is not large enough, 
or if an error ocurrs in a lower-level function. 


GETENV(3C) 


NAME 
getenv — return value for environment name 

SYNOPSIS 
char *getenv (name) 
char *name; 

DESCRIPTION 
Getenv searches the environment list (see environ(5)) for 
a string of the form name=value, and returns a pointer 
to the value in the current environment if such a string 
is present, otherwise a NULL pointer. 

SEE ALSO 
exec(2), putenv(3C), environ(5). 


NAME 


GETGRENT (3C) 


getgrent, getgrgid, getgrnam, setgrent, endgrent, 
fgetgrent — get group file entry 


SYNOPSIS 


#include <grp.h> 
struct group *getgrent ( ) 


struct group *getgrgid (gid) 
int gid; 


struct group *getgrnam (name) 
char *name; 


void setgrent ( ) 
void endgrent ( ) 


struct group *fgetgrent (f) 
FILE *f; 


DESCRIPTION 
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Getgrent, getgrgid and getgrnam each return pointers to 
an object with the following structure containing the 
broken-out fields of a line in the /ete/group file. Each 
line contains a ‘‘group” structure, defined in the 
<grp-h> header file. 


struct group { 
char *gr_name; 
/* the name of the group */ 
char *gr_passwd; 
/* the encrypted group password */ 
int gr_gid; 
/* the numerical group ID */ 
char **gr_mem; 
; /* vector of pointers to member names */ 
’ 
Getgrent when first called returns a pointer to the first 
group structure in the file; thereafter, it returns a pointer 
to the next group structure in the file; so, successive calls 
may be used to search the entire file. Getgrgid searches 
from the beginning of the file until a numerical group id 
matching gtd is found and returns a pointer to the 
particular structure in which it was found. Getgrnam 
searches from the beginning of the file until a group 
name matching name is found and returns a pointer to 
the particular structure in which it was found. If an 
end-of-file or an error is encountered on reading, these 
functions return a NULL pointer. 


A call to setgrent has the effect of rewinding the group 
file to allow repeated searches. Endgrent may be called 
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to close the group file when processing is complete. 
Fgetgrent returns a pointer to the next group structure 
in the stream f, which matches the format of 
/etc/group. 


FILES 
/etc/group 

SEE ALSO 
getlogin(3C), getpwent(3C), group(4). 

DIAGNOSTICS 
A NULL pointer is returned on EOF or error. 

WARNING 
The above routines use <stdio.h>, which causes them 
to increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 

BUGS 


All information is contained in a static area, so it must 
be copied if it is to be saved. 


GETHOSTENT (3N) 


NAME 
gethostent, gethostbyaddr, gethostbyname, sethostent, 
endhostent — get network host entry 

SYNOPSIS 
#include <netdb.h> 


struct hostent *gethostent( ) 


struct hostent *gethostbyname (name) 
char *name; 


struct hostent *gethostbyaddr(addr, len, type) 
char *addr; int len, type; 

sethostent (stayopen) 

int stayopen 


endhostent ( ) 


DESCRIPTION 
Gethostent, gethostbyname, and _ gethostbyaddr each 
return a pointer to an object with the following structure 
containing the broken-out fields of a line in the network 
host data base, /etc/hosts. 


struct hostent { 
char *h_name; /* official name of host */ 
char **h_aliases; /* alias list */ 
int h_addrtype; /* address type */ 
int h_length; /* length of address */ 
char *h_addr; /* address */ 


} 


The members of this structure are: 
h_name Official name of the host. 


h_aliases A zero terminated array of alternate names 
for the host. 


h_addrtype The type of address being returned; 
currently always AF_INET. 

h_length The length, in bytes, of the address. 

h_addr A pointer to the network address for the 


host. Host addresses are returned in 
network byte order. 


Gethostent reads the next line of the file, opening the file 
if necessary. 


Sethostent opens and rewinds the file. If the stayopen 
flag is non-zero, the host data base will not be closed 
after each call to gethostent (either directly, or indirectly 
through one of the other gethost calls). 
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Endhostent closes the file. 


Gethostbyname and gethostbyaddr sequentially search 
from the beginning of the file until a matching host 
name or host address is found, or until EOF is 
encountered. Host addresses are supplied in network 
order. 


/etc /hosts 


SEE ALSO 


hosts(4N). 
CTIX Internetworking Manual. 


DIAGNOSTICS 


BUGS 


NOTE 
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Null pointer (0) returned on EOF or error. 


All information is contained in a static area so it must be 
copied if it is to be saved. Only the Internet address 
format is currently understood. 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
gethostname — get name of current host 


SYNOPSIS 
gethostname (name, namelen) 
char *name; 
int namelen; 


DESCRIPTION 
Gethostname returns the standard host name for the 
current processor, as previously set by setuname(1M). 
The parameter namelen specifies the size of the name 
array. The returned name is null-terminated unless 
insufficient space is provided. 

RETURN VALUE 
If the call succeeds, a value of 0 is returned. If the call 
fails, then a value of —1 is returned and an error code is 
placed in the global location errno. 


ERRORS 
The following errors may be returned by these calls: 
[EFAULT] The name or namelen parameter gave 
an invalid address. 
[EPERM] The caller was not the super-user. 
SEE ALSO 
setuname(1M). 
CTIX Internetworking Manual. 
BUGS 
Host names are limited to 9 characters. 
NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
getlogin — get login name 
SYNOPSIS 
char *getlogin ( ); 
DESCRIPTION 
Getlogin returns a pointer to the login name as found in 
/etc/utmp. It may be used in conjunction with 
getpwnam to locate the correct password file entry when 
the same user ID is shared by several login names. 
If getlogin is called within a process that is not attached 
to a terminal, it returns a NULL pointer. The correct 
procedure for determining the login name is to call 
cusertd, or to call getlogin and if it fails to call getpwuid. 
FILES 
/etc/utmp 
SEE ALSO 
cuserid(3S), getgrent(3C), getpwent(3C), utmp(4). 
DIAGNOSTICS 
Returns the NULL pointer if name is not found. 
BUGS 


The return values point to static data whose content is 
overwritten by each call. 


NAME 


GETNETENT (3N) 


getnetent, getnetbyaddr, getnetbyname,  setnetent, 
endnetent — get network entry 


SYNOPSIS 


#include <netdb.h> 
struct netent “getnetent ( ) 


struct netent *getnetbyname (name) 
char *name; 


struct netent *getnetbyaddr (net) 
long net; 


setnetent (stayopen) 
int stayopen 


endnetent ( ) 


DESCRIPTION 
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Getnetent, getnetbyname, and getnetbyaddr each return a 
pointer to an object with the following structure 
containing the broken-out fields of a line in the network 
data base, /etc/networks. 


struct netent { 
char *n_name;  /* official name of net */ 
char **n_aliases; /* alias list */ 
int n_addrtype; /* net number type */ 
long n_net; /* net number */ 


ie 


The members of this structure are: 
n_name The official name of the network. 


n_aliases A zero-terminated list of alternate names 
for the network. 


n_addrtype The type of the network number returned; 
currently only AF_INET. 


n_net The network number. Network numbers 
are returned in machine byte order. 


Getnetent reads the next line of the file, opening the file 
if necessary. 


Setnetent opens and rewinds the file. If the stayopen flag 
is non-zero, the network data base will not be closed 
after each call to getnetent (either directly, or indirectly 
through one of the other getnet calls). 

Endnetent closes the file. 


Getnetbyname and getnetbyaddr sequentially search from 
the beginning of the file until a matching net name or 
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net address is found, or until EOF is encountered. 
Network numbers are supplied in host order. 
FILES 
/etc/networks 
SEE ALSO 
networks(4N). 
CTIX Internetworking Manual. 
DIAGNOSTICS 
Null pointer (0) returned on EOF or error. 
BUGS 
All information is contained in a static area, so it must 
be copied if it is to be saved. Only Internet network 
numbers are currently understood. Expecting network 
numbers to fit in no more than 32 bits is probably naive. 
NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
getopt — get option letter from argument vector 


SYNOPSIS 
int getopt (arge, argv, optstring) 
int arge; 
char **argv, *opstring; 


extern char *optarg; 
extern int optind, opterr; 


DESCRIPTION 

Getopt returns the next option letter in argv that 
matches a letter in optstring. Optstring is a string of 
recognized option letters; if a letter is followed by a 
colon, the option is expected to have an argument that 
may or may not be separated from it by white space. 
Optarg is set to point to the start of the option 
argument on return from getopt. 


Getopt places in optind the argv index of the next 
argument to be processed. Because optind is external, it 
is normally initialized to zero automatically before the 
first call to getopt. 


When all options have been processed (i.e., up to the 
first non-option argument), gefopt returns EOF. The 
special option —— may be used to delimit the end of the 
options; EOF will be returned, and —— will be skipped. 


DIAGNOSTICS 
Getopt prints an error message on stderr and returns a 
question mark (?) when it encounters an option letter not 
included in optstring. This error message may be 
disabled by setting opterr to a non-zero value. 


EXAMPLE 
The following code fragment shows how one might 
process the arguments for a command that can take the 
mutually exclusive options a and b, and the options f 
and o, both of which require arguments: 
main (argc, argv) 
int argc; 
char **argv; 


int ¢; 
extern char *optarg; 
extern int optind; 


while 
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((c = getopt(arge, argv, "abf:o:”)) != EOF) 
switch (c) 


ifile = optarg; 


if (errflg) { 
co "usage: ... "); 


exit (2); 


} 
for ( ; optind < arge; oping Ft) { 
if (access(argvloptind], 4)) { 


} 


SEE ALSO 
getopt(1). 


NAME 


GETPASS(3C) 


getpass — read a password 


SYNOPSIS 


char *getpass (prompt) 
char *prompt; 


DESCRIPTION 


Getpass reads up to a newline or EOF from the file 
/dev/tty, after prompting on the standard error output 
with the null-terminated string prompt and disabling 
echoing. A pointer is returned to a null-terminated 
string of at most 8 characters. If /dev/tty cannot be 
opened, a NULL pointer is returned. An interrupt will 
terminate input and send an interrupt signal to the 
calling program before returning. 


FILES 
/dev /tty 

SEE ALSO 
erypt(3C). 

WARNING 
The above routine uses <stdio.h>, which causes it to 
increase the size of programs not otherwise using 
standard I/O, more than might be expected. 

BUGS 


The return value points to static data whose content is 
overwritten by each call. 


NAME 


GETPROTOENT(3N) 


getprotoent, getprotobynumber, getprotobyname, 
setprotoent, endprotoent — get protocol entry 


SYNOPSIS 


#include <netdb.h> 
struct protoent *getprotoent ( ) 


struct protoent *getprotobyname (name) 
char *name; 


struct protoent *getprotobynumber (proto) 
int proto; 


setprotoent (stayopen) 
int stayopen 


endprotoent ( ) 


DESCRIPTION 


FILES 
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Getprotoent, getprotobyname, and _ getprotobynumber 
each return a pointer to an object with the following 
structure containing the broken-out fields of a line in the 
network protocol data base, /ete/protocols. 


struct protoent { 


char *p_name; /* official name of protocol */ 
char **p_aliases; /* alias list */ 
long p_proto; /* protocol number */ 


, 


The members of this structure are: 
p_name- The official name of the protocol. 


pualiases A zero-terminated list of alternate names for 
the protocol. 


p proto The protocol number. 


Getprotoent reads the next line of the file, opening the 
file if necessary. 


Setprotoent opens and rewinds the file. If the stayopen 
flag is non-zero, the network data base will not be closed 
after each call to getprotoent (either directly, or 
indirectly through one of the other getproto calls). 


Endprotoent closes the file. 


Getprotobyname and _ getprotobynumber sequentially 
search from the beginning of the file until a matching 
protocol name or protocol number is found, or until EOF 
is encountered. 


/ete/protocols 
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SEE ALSO 
protocols(4N). 
CTIX Internetworking Manual. 

DIAGNOSTICS 
Null pointer (0) returned on EOF or error. 

BUGS 
All information is contained in a static area, so it must 
be copied if it is to be saved. Only the Internet 
protocols are currently understood. 

NOTE 
This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
getpw — get name from UID 


SYNOPSIS 
int getpw (uid, buf) 
int uid; 
char *buf; 

DESCRIPTION 
Getpw searches the password file for a user id number 
that equals utd, copies the line of the password file in 
which utd was found into the array pointed to by buf, 
and returns 0. Getpw returns non-zero if uid cannot be 
found. 


This routine is included only for compatibility with prior 
systems and should not be used; see getpwent(3C) for 
routines to use instead. 
FILES 
/etc/passwd 
SEE ALSO 
getpwent(3C), passwd(4). 
DIAGNOSTICS 
Getpw returns non-zero on error. 
WARNING 
The above routine uses <stdio.h>, which causes it to 


increase, more than might be expected, the size of 
programs, not otherwise using standard I/O. 


NAME 


GETPWENT (3C) 


getpwent, getpwuid, getpwnam, setpwent, endpwent, 
fgetpwent — get password file entry 


SYNOPSIS 


#include <pwd.h> 
struct passwd *getpwent ( ) 


struct passwd *getpwuid (uid) 
fae: ods 


struct passwd *getpwnam (name) 
char *name; 


void setpwent ( ) 
void endpwent ( ) 


struct passwd *fgetpwent (f) 
FILE *f; 


DESCRIPTION 


Getpwent, getpwutd and getpwnam each returns a 
pointer to an object with the following structure 
containing the broken-out fields of a line in the 
/etc/passwd file. Each line in the file contains a 
‘“‘passwd”’ structure, declared in the <pwd.h> header 
file: 


struct passwd { 
char *pw_name; 
char *pw_passwd; 
int pw_uid; 
int pw_gid; 
char *pw_age; 
char *pw_comment; 
char *DW_gecos; 
char *pw_dir; 
char *pw_shell; 
This structure is declared in <pwd.h> so it is not 
necessary to redeclare it. 


The pw_comment field is unused; the others have 
meanings described in passwd(4). 


Getpwent when first called returns a pointer to the first 
passwd structure in the file; thereafter, it returns a 
pointer to the next passwd structure in the file; so 
successive calls can be used to search the entire file. 
Getpwutd searches from the beginning of the file until a 
numerical user id matching ufd is found and returns a 
pointer to the particular structure in which it was found. 
Getpwnam searches from the beginning of the file until a 
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login name matching name is found, and returns a 
pointer to the particular structure in which it was found. 
If an end-of-file or an error is encountered on reading, 
these functions return a NULL pointer. 


A call to setpwent has the effect of rewinding the 
password file to allow repeated searches. Endpwent may 
be called to close the password file when processing is 
complete. 


Fgetpwent returns a pointer to the next passwd structure 
in the stream f, which matches the format of 
/etc/passwd. 


/etc/passwd 


SEE ALSO 


getlogin(3C), getgrent(3C), passwd(4). 


DIAGNOSTICS 


A NULL pointer is returned on EOF or error. 


WARNING 


BUGS 


The above routines use <stdio.h>, which causes them 
to increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 


All information is contained in a static area, so it must 
be copied if it is to be saved. 


GETS(3S) 


NAME 
gets, fgets — get a string from a stream 


SYNOPSIS 
#include <stdio.h> 


char *gets (s) 
char *s; 


char *fgets (s, n, stream) 
char *s; 

int n; 

FILE *stream; 


DESCRIPTION 
Gets reads characters from the standard input stream, 
stdin, into the array pointed to by s, until a new-line 
character is read or an_ end-of-file condition is 
encountered. The new-line character is discarded and 
the string is terminated with a null character. 


Fgets reads characters from the stream into the array 
pointed to by 8, until n—1 characters are read, or a 
new-line character is read and transferred to s, or an 
end-of-file condition is encountered. The string is then 
terminated with a null character. 


SEE ALSO 
ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S). 


DIAGNOSTICS 
If end-of-file is encountered and no characters have been 
read, no characters are transferred to s and a NULL 
pointer is returned. If a read error occurs, such as trying 
to use these functions on a file that has not been opened 
for reading, a NULL pointer is returned. Otherwise s is 
returned. 


NAME 
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getservent, getservbyport, getservbyname, setservent, 
endservent — get service entry 


SYNOPSIS 


#include <netdb.h> 
struct servent *getservent ( ) 


struct servent *getservbyname (name, proto) 
char *name, *proto; 


struct servent *getservbyport (port, proto) 
int port; char “proto; 


setservent (stayopen) 
int stayopen 


endservent ( ) 


DESCRIPTION 
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Getservent, getservbyname, and _ getservbyport each 
return a pointer to an object with the following structure 
containing the broken-out fields of a line in the network 
services data base, /etc/services. 


struct servent { 
char *s_name; /* official name of service */ 
char **s_aliases; /* alias list */ 
long s_port; /* port service resides at */ 
char *s_proto; /* protocol to use */ 


}; 
The members of this structure are: 
s.name The official name of the service. 


s_aliases A zero-terminated list of alternate names for 
the service. 


s_port The port number at which the service resides. 
Port numbers are returned in network byte 
order. 


s_proto The name of the protocol to use when 
contacting the service. 


Getservent reads the next line of the file, opening the file 
if necessary. 


Setservent opens and rewinds the file. If the stayopen 
flag is non-zero, the network data base will not be closed 
after each call to getservent (either directly, or indirectly 
through one of the other getserv calls). 


Endservent closes the file. 


Getservbyname and getservbyport sequentially search 
from the beginning of the file until a matching protocol 
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name or port number is found, or until EOF is 
encountered. If a protocol name is also supplied (non- 
NULL), searches must also match the protocol. 


FILES 
/etc /services 
SEE ALSO 
getprotoent(3N), services(4N). 
CTIX Internetworking Manual. 
DIAGNOSTICS 
Null pointer (0) returned on EOF or error. 
BUGS 
All information is contained in a static area, so it must 
be copied if it is to be saved. Expecting port numbers to 
fit in a 32-bit quantity is probably naive. 
NOTE 
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This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


GETUT(3C) 


NAME 
getutent, getutid, getutline, pututline,  setutent, 
endutent, utmpname — access utmp file entry 


SYNOPSIS 
#include <utmp.h> 


struct utmp *getutent ( ) 


struct utmp *getutid (id) 
struct utmp *id; 


struct utmp *getutline (line) 
struct utmp ‘line; 


void pututline (utmp) 
struct utmp *utmp; 


void setutent ( ) 
void endutent ( ) 


void utmpname (file) 
char ‘file; 


DESCRIPTION 
Getutent, getuttd and getutline each return a pointer to 
a structure of the following type: 


struct utmp { 
char ut_user|8}; 
/* User login name */ 


char ut_id[4]; 
/* /etc/inittab id 
* (usually line #) */ 
char ut_line[12]; 
* device name (console, 
* Inxx) */ 
short ut_pid; /* process id */ 
short ut_type; /* type of entry */ 
struct exit_status 
short e_termination; 
/* Process termination status */ 
short e_exit; 
/* Process exit status */ 
} ut_exit; 
/* The exit status of a process 
/* marked as DEAD_PROCESS. */ 
time_t ut_time; 
/* time entry was made */ 
Getutent reads in the next entry from a utmp-like file. 
If the file is not already open, it opens it. If it reaches 
the end of the file, it fails. 
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Getuttd searches forward from the current point in the 
utmp file until it finds an entry with a ut_type matching 
td->ut_type if the type specified is RUN_LVL, 
BOOT_TIME, OLD_TIME or NEW_TIME. If the type 
specified in td is INIT.PROCESS, LOGIN_PROCESS, 
USER_PROCESS or DEAD_PROCESS, then getuttd will 
return a pointer to the first entry whose type is one of 
these four and whose ut_td field matches td->ut_td. If 
the end of file is reached without a match, it fails. 


Getutline searches forward from the current point in the 
utmp file until it finds an entry of the type 
LOGIN_PROCESS or USER_PROCESS which also has a 
ut_line string matching the line->ut_line string. If the 
end of file is reached without a match, it fails. 


Pututline writes out the supplied utmp structure into the 
utmp file. It uses getuttd to search forward for the 
proper place if it finds that it is not already at the 
proper place. It is expected that normally the user of 
pututline will have searched for the proper entry using 
one of the getut routines. If so, pututline will not search. 
If pututline does not find a matching slot for the new 
entry, it will add a new entry to the end of the file. 


Setutent resets the input stream to the beginning of the 
file. This should be done before each search for a new 
entry if it is desired that the entire file be examined. 


Endutent closes the currently open file. 


Utmpname allows the user to change the name of the file 
examined, from /etc/utmp to any other file. It is most 
often expected that this other file will be /ete/wtmp. 
If the file does not exist, this will not be apparent until 
the first attempt to reference the file is made. 
Utmpname does not open the file. It just closes the old 
file if it is currently open and saves the new file name. 


/etc/utmp 
/etc/wtmp 


SEE ALSO 


ttyslot(3C), utmp(4). 


DIAGNOSTICS 


A NULL pointer is returned upon failure to read, 
whether for permissions or having reached the end of 
file, or upon failure to write. 


COMMENTS 


The most current entry is saved in a static structure. 
Multiple accesses require that it be copied before further 
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accesses are made. Each call to either getutid or 
getutline sees the routine examine the static structure 
before performing more 1/O. If the contents of the static 
structure match what it is searching for, it looks no 
further. For this reason to use getutline to search for 
multiple occurrences, it would be necessary to zero out 
the static after each success, or getutline would just 
return the same pointer over and over again. There is 
one exception to the rule about removing the structure 
before further reads are done. The implicit read done by 
pututline (if it finds that it is not already at the correct 
place in the file) will not hurt the contents of the static 
structure returned by the getutent, getutid or getutline 
routines, if the user has just modified those contents and 
passed the pointer back to pututline. 


These routines use buffered standard I/O for input, but 
pututline uses an unbuffered non-standard write to avoid 
race conditions between processes trying to modify the 
utmp and wtmp files. 
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NAME 
hsearch, hcreate, hdestroy — manage hash search tables 


SYNOPSIS 
#include <search.h> 


ENTRY *hsearch (item, action) 
ENTRY item; 
ACTION action; 


int hereate (nel) 
unsigned nel; 


void hdestroy ( ) 


DESCRIPTION 

Hesearch is a hash-table search routine generalized from 
Knuth (6.4) Algorithm D. It returns a pointer into a 
hash table indicating the location at which an entry can 
be found. Item is a structure of type ENTRY (defined in 
the <search.h> header file) containing two pointers: 
ttem.key points to the comparison key, and ttem.data 
points to any other data to be associated with that key. 
(Pointers to types other than character should be cast to 
pointer-to-character.) Action is a member of an 
enumeration type ACTION indicating the disposition of 
the entry if it cannot be found in the table) ENTER 
indicates that the item should be inserted in the table at 
an appropriate point. FIND indicates that no entry 
should be made. Unsuccessful resolution is indicated by 
the return of a NULL pointer. 


Hereate allocates sufficient space for the table, and must 
be called before hsearch is used. Nel is an estimate of 
the maximum number of entries that the table will 
contain. This number may be adjusted upward by the 
algorithm in order to obtain certain mathematically 
favorable circumstances. 


Hdestroy destroys the search table, and may be followed 
by another call to Acreate. 


NOTES 
Heearch uses open addressing with a multiplicative hash 
function. However, its source code has many other 
options available which the user may select by compiling 
the Asearch source with the following symbols defined to 
the preprocessor: 


DIV Use the remainder modulo table stze as the 
hash function instead of the multiplicative 
algorithm. 


USCR Use a User Supplied Comparison Routine for 
ascertaining table membership. The routine 
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should be named Acompar and should behave 


in a mannner similar to stremp (see 
string(3C)). 

CHAINED 
Use a linked list to resolve collisions. If this 


option is selected, the following other options 
become available. 


START Place new entries at the 
beginning of the linked list 
(default is at the end). 


SORTUP Keep the linked list sorted by 
key in ascending order. 


SORTDOWN 
Keep the linked list sorted by 
key in descending order. 


Additionally, there are preprocessor flags for obtaining 
debugging printout (-DDEBUG) and for including a test 
driver in the calling routine (-DDRIVER). The source 
code should be consulted for further details. 


EXAMPLE 
The following example will read in strings followed by 
two numbers and store them in a hash table, discarding 
duplicates. It will then read in strings and find the 
matching entry in the hash table and print it out. 


#include <stdio.h> 
#include <search.h> 


struct info { 
/* this is the info stored in the table */ 
int age, room; 
/* other than the key. */ 
}; 
#define NUM_EMPL 5000 
/* # of elements in search table */ 


main( ) 
{ 
/* space to store strings */ 
char string_space|NUM_EMPL*20]; 
/* space to store employee info */ 
struct info info_space|/NUM_EMPL]; 
/* next avail space in string_space */ 
char *str_ptr = string_space; 
/* next avail space in info_space */ 
struct info *info_ptr = info_space; 
ENTRY item, *found_item, *hsearch( ); 
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/* name to look for in table */ 
char name_to_find(30]; 
int i = 0; 


/* create table */ 
{void) hereate(NUM_EMPL); 
while (scanf("%s%d%d”, str_ptr, Linfo_ptr—>age, 
&info_ptr->room) |= EOF && i++ < NUM_EMPL) { 
/* put info in structure, and structure in item */ 
item.key = str_ptr; 
item.data = (char *)info_ptr; 
str_ptr += strlen(str_ptr) + 1; 
info_ptr++; 
/* put item into table */ 
(void) hsearch(item, ENTER); 


/* access table */ 
item.key = name_to_find; 
while (scanf("%s", item.key) != EOF) { 
if ((found_item = hsearch(item, FIND)) != NULL) { 
/* if item is in the table #/ 
(void)printf("found %s, age = %d, room = %d\n", 
found_item-> key, 
((struct info *)found_item- > data)->age, 
((struct info *)found_item—>data)- >room); 
} else { 
(void)printf("no such employee %s\n”, 
name_to_find) 


} 
} 

SEE ALSO 
bsearch(3C), —Isearch(3C), = malloc(3C), — malloc(3X), 
string(3C), tsearch(3C). 

DIAGNOSTICS 
Hsearch returns a NULL pointer if either the action is 
FIND and the item could not be found or the action is 
ENTER and the table is full. 
Hereate returns zero if it cannot allocate sufficient space 
for the table. 

WARNING 
Hesearch and hereate use malloc(3C) to allocate space. 

BUGS 


Only one hash search table may be active at any given 
time. 
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NAME 

hypot — Euclidean distance function 
SYNOPSIS 

#include <math.h> 

double hypot (x, y) 

double x, y; 
DESCRIPTION 

HAypot returns 

sqri(x *x + y * y), 

taking precautions against unwarranted overflows. 

DIAGNOSTICS 


When the correct value would overflow, Aypot returns 
HUGE and sets errno to ERANGE. 


These error-handling procedures may be changed with 
the function matherr(3M). 


SEE ALSO 
matherr(3M), exp(3M). 
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NAME 
inet_addr, inet_network, inet_ntoa, inet_makeaddr, 
inet_Inaof, inet_netof — Internet address manipulation 
routines 


SYNOPSIS 
#include <sys/socket.h> 
#include <netinet/in.h> 
#include <arpa/inet.h> 


struct in_addr inet_addr(cp) 
char “cp; 


int inet_network(cp) 
char *cp; 


char *inet_ntoa(in) 
struct inet_addr in; 


struct in_addr inet_makeaddr(net, Ina) 
int net, Ina; 


int inet_Inaof(in) 
struct in_addr in; 


int inet_netof(in) 
struct in_addr in; 


DESCRIPTION 

The routines tnet_addr and inet_network each interpret 
character strings representing numbers expressed in the 
Internet standard dot notation, returning numbers 
suitable for use as Internet addresses and Internet 
network numbers, respectively. The routine inet_ntoa 
takes an Internet address and returns an ASCII string 
representing the address in dot notation. The routine 
tnet_makeaddr takes an Internet network number and a 
local network address and constructs an Internet address 
from it. The routines inet_netof and inet_Inaof break 
apart Internet host addresses, returning the network 
number and local network address part, respectively. 


All Internet address are returned in network order (bytes 
ordered from left to right). All network numbers and 
local address parts are returned as machine format 
integer values. 


INTERNET ADDRESSES 
Values specified using the dot notation take one of the 
following forms: 
a.b.c.d 
a.b.c 


a.b 


a 
When four parts are specified, each is interpreted as a 
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byte of data and assigned, from left to right, to the four 
bytes of an Internet address. Note that when an 
Internet address is viewed as a 32-bit integer quantity on 
the VAX the bytes referred to above appear as d.c.b.a. 
That is, VAX bytes are ordered from right to left. 


When a three part address is specified, the last part is 
interpreted as a 16-bit quantity and placed in the right 
most two bytes of the network address. This makes the 
three part address format convenient for specifying Class 
B network addresses as 128.net.host. 


When a two part address is supplied, the last part is 
interpreted as a 24-bit quantity and placed in the right 
most three bytes of the network address. This makes 
the two part address format convenient for specifying 
Class A network addresses as net.host. 


When only one part is given, the value is stored directly 
in the network address without any byte rearrangement. 


All numbers supplied as parts in a . notation may be 
decimal, octal, or hexadecimal, as specified in the C 
language (i.e., a leading Ox or OX implies hexadecimal; 
otherwise, a leading 0 implies octal; otherwise, the 
number is interpreted as decimal). 


SEE ALSO 


gethostent(3N), getnetent(3N), hosts(4N), networks(4N). 
OCTIX Internetworking Manual. 


DIAGNOSTICS 


BUGS 


NOTE 


The value —1 is returned by tnet_addr and tnet_network 
for malformed requests. 


The problem of host byte ordering versus network byte 
ordering is confusing. A simple way to specify Class C 
network addresses in a manner similar to that for Class 
B and Class A is needed. The string returned by 
tnet_ntoa resides in a static memory area. 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
13tol, ltol8 -— convert between 3-byte integers and long 
integers 


SYNOPSIS 
void 13tol (Ip, ep, n) 
long *lp; 
char *cp; 
int n; 


void Itol3 (cp, Ip, n) 
char *cp; 
long *lp; 
int n; 

DESCRIPTION 
L8tol converts a list of n three-byte integers packed into 
a character string pointed to by cp into a list of long 
integers pointed to by Ip. 
Ltol8 performs the reverse conversion from long integers 
(Ip) to three-byte integers (cp). 
These functions are useful for file-system maintenance 
where the block numbers are three bytes long. 


SEE ALSO 
fs(4). 


BUGS 
Because of possible differences in byte ordering, the 
numerical values of the long integers are machine- 
dependent. 
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NAME 
ldahread — read the archive header of a member of an 
archive file 


— SYNOPSIS 
#finclude <stdio.h> 
#include <ar.h> 
#include <filehdr.h> 
#include <Idfcen.h> 


int Idahread (Idptr, arhead) 
LDFILE *ldptr; 
ARCHDR *arhead; 


DESCRIPTION 
If TYPE(/dptr) is the archive file magic number, 
ldahread reads the archive header of the common object 
file currently associated with Idptr into the area of 
memory beginning at arhead. 


Ldahread returns SUCCESS or FAILURE. Ldahread 
will fail if TYPE(/dptr) does not represent an archive 
file, or if it cannot read the archive header. 
The program must be loaded with the object file access 
— routine library libld.a. 

FILES 
/usr/lib/libld.a 

SEE ALSO 
Idclose(3X), Idopen(3X), Idfen(4), ar(4). 


NAME 
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Idclose, Idaclose — close a common object file 


SYNOPSIS 


#include <stdio.h> 
#finclude <filehdr.h> 
#include <Idfen.h> 


int Idclose (Idptr) 
LDFILE *ldptr; 


int Idaclose (Idptr) 
LDFILE *lIdptr; 


DESCRIPTION 


FILES 


Ldopen(3X) and Idclose are designed to provide uniform 
access to both simple object files and object files that are 
members of archive files. Thus an archive of common 
object files can be processed as if it were a series of 
simple common object files. 


If TYPE(Idptr) does not represent an archive file, idclose 
will close the file and free the memory allocated to the 
LDFILE structure associated with Idptr. If TYPE((dptr) 
is the magic number of an archive file, and if there are 
any more files in the archive, (dclose will reinitialize 
OFFSET(Idptr) to the file address of the next archive 
member and return FAILURE. The LDFILE structure 
is prepared for a subsequent Idopen(3X). In all other 
cases, (dclose returns SUCCESS. 


Ldaclose closes the file and frees the memory allocated to 
the LDFILE structure associated with /dptr regardless of 
the value of TYPE/(Idpir). Ldaclose always returns 
SUCCESS. The function is often used in conjunction 
with [daopen. 


The program must be loaded with the object file access 
routine library libld.a. 


/usr/lib/libld.a 


SEE ALSO 


fclose(3S), ldopen(3X), Idfen(4). 
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ldfhread — read the file header of a common object file 


SYNOPSIS 


#finclude <stdio.h> 
#include <filehdr.h> 
#include <Idfen.h> 


int ldfhread (ldptr, filehead) 
LDFILE *ldptr; 
FILHDR *filehead; 


DESCRIPTION 


FILES 


Ldfhread reads the file header of the common object file 
currently associated with /dptr into the area of memory 
beginning at filehead. 

Ldfhread returns SUCCESS or FAILURE. Ldfhread will 
fail if it cannot read the file header. 


In most cases the use of [dfhread can be avoided by using 
the macro HEADER(Idptr) defined in Idfcn.h (see 
Idfen(4)). The information in any field, fieldname, of the 
file header may be accessed using 

HEADER (ldptr).fieldname. 


The program must be loaded with the object file access 
routine library libld.a. 


/usr/lib/libld.a 


SEE ALSO 


Idclose(3X), Idopen(3X), Idfen(4). 
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NAME 
Idgetname — retrieve symbol name for common object 
file symbol table entry 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <Idfcen.h> 


char *ldgetname (ldptr, symbol) 
LDFILE *ldptr; 
SYMENT *symbol; 


DESCRIPTION 
Ldgetname returns a pointer to the name associated with 
symbol as a string. The string is contained in a static 
buffer local to Idgetname that is overwritten by each call 
to ldgetname, and therefore must be copied by the caller 
if the name is to be saved. 


As of UNIX system release 5.0, which corresponds to the 
first release of CTIX, the common object file format has 
been extended to handle arbitrary length symbol names 
with the addition of a “string table’. Ldgetname will 
return the symbol name associated with a symbol table 
entry for either a pre-UNIX system 5.0 object file or a 
UNIX system 5.0 object file. Thus, /dgetname can be 
used to retrieve names from object files without any 
backward compatibility problems. Ldgetname_ will 
return NULL (defined in stdio.h) for a UNIX system 5.0 
object file if the mame cannot be retrieved. This 
situation can occur: 


- if the ‘‘string table’? cannot be found, 


- if not enough memory can be allocated for the 
string table, 


- if the string table appears not to be a string 
table (for example, if an auxiliary entry is 
handed to [dgetname that looks like a reference 
to a name in a non-existent string table), or 


- if the name’s offset into the string table is past 
the end of the string table. 


Typically, ldgetname will be called immediately after a 
successful call to [dtbread to retrieve the name associated 
with the symbol table entry filled by Idtbread. 


The program must be loaded with the object file access 
routine library libld.a. 
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FILES 


/usr/lib/libld.a 

SEE ALSO 
TPA ek Idopen(3X), Idtbread(3X), 
Idfen(4). 


Idtbseek(3X), 
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NAME 
Idlread, Idlinit, ldlitem — manipulate line number entries 
of a common object file function 


SYNOPSIS 
#include <stdio.h> 
#iinclude <filehdr.h> 
#include <linenum.h> 
#include <Idfcn.h> 


int Idlread(Idptr, fenindx, linenum, linent) 
LDFILE *ldptr; 

long fenindx; 

unsigned short linenum; 

LINENO linent; 


int Idlinit(Idptr, fenindx) 
LDFILE +*ldptr; 
long fenindx; 


int Idlitem(Idptr, linenum, linent) 
LDFILE *ldptr; 

unsigned short linenum; 

LINENO linent; 


DESCRIPTION 

Ldlread searches the line number entries of the common 
object file currently associated with Idptr. Ldlread 
begins its search with the line number entry for the 
beginning of a function and confines its search to the line 
numbers associated with a single function. The function 
is identified by fenindz, the index of its entry in the 
object file symbol table. Ldlread reads the entry with 
the smallest line number equal to or greater than 
linenum into linent. 


Ldlinit and Idlitem together perform exactly the same 
function as Idlread. After an initial call to (dlread or 
Idlintt, Idiitem may be used to retrieve a series of line 
number entries associated with a single function. Ldlinit 
simply locates the line number entries for the function 
identified by fentndz. Ldlitem finds and reads the entry 
with the smallest line number equal to or greater than 
linenum into linent. 


Ldlread, Idlintt, and Idlitem each return either 
SUCCESS or FAILURE. Ldlread will fail if there are 
no line number entries in the object file, if fenindz does 
not index a function entry in the symbol table, or if it 
finds no line number equal to or greater than linenum. 
Ldlinit will fail if there are no line number entries in the 
object file or if fenindz does not index a function entry in 
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the symbol table. Ldlitem will fail if it finds no line 
number equal to or greater than linenum. 


The programs must be loaded with the object file access 
routine library libld.a. 
FILES 
/usr/lib/libld.a 
SEE ALSO 
Idclose(3X), Idopen(3X), Idtbindex(3X), Idfcn(4). 
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Idlseek, ldnlseek — seek to line number entries of a 
section of a common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcen.h> 

int Idlseek (Idptr, sectindx) 
LDFILE +*ldptr; 

unsigned short sectindx; 

int Idniseek (ldptr, sectname) 
LDFILE +*ldptr; 

char *sectname; 


DESCRIPTION 


FILES 


Ldiseek seeks to the line number entries of the section 
specified by sectindz of the common object file currently 
associated with [dptr. 


Ldnlseek seeks to the line number entries of the section 
specified by sectname. 


Ldlseek and Idniseek return SUCCESS or FAILURE. 
Ldlseek will fail if sectindz is greater than the number of 
sections in the object file; Idnlseek will fail if there is no 
section name corresponding with *sectname. Either 
function will fail if the specified section has no line 
number entries or if it cannot seek to the specified line 
number entries. 


Note that the first section has an index of one. 


The program must be loaded with the object file access 
routine library libld.a. 


/usr/lib/libld.a 


SEE ALSO 


Idclose(3X), ldopen(3X), Idshread(3X), Idfen(4). 


NAME 
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Idohseek — seek to the optional file header of a common 
object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfen.h> 


int Idohseek (Idptr) 
LDFILE *ldptr; 


DESCRIPTION 


FILES 


Ldohseek seeks to the optional file header of the common 
object file currently associated with Idptr. 


Ldohseek returns SUCCESS or FAILURE. Ldohseek 
will fail if the object file has no optional header or if it 
cannot seek to the optional header. 


The program must be loaded with the object file access 
routine library libld.a. 


/usr/lib/libld.a 


SEE ALSO 


Idclose(3X), Idopen(3X), Idfhread(3X), Idfen(4). 


LDOPEN (3X) 


NAME 
Idopen, Idaopen — open a common object file for reading 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <Idfen.h> 


LDFILE *ldopen (filename, Idptr) 
char *filename; 
LDFILE *ldptr; 


LDFILE *ldaopen (filename, oldptr) 
char *filename; 
LDFILE *oldptr; 


DESCRIPTION 
Ldopen and oreda ee are designed to provide uniform 
access to both simple object files and object files that are 
members of archive files. Thus an archive of common 
object files can be processed as if it were a series of 
simple common object files. 


If idptr has the value NULL, then Idopen will open 
filename and allocate and initialize the LDFILE 
structure, and return a pointer to the structure to the 
calling program. 


If [dptr is valid and if TYPE(Idptr) is the archive magic 
number, /dopen will reinitialize the LDFILE structure for 
the next archive member of filename. 


Ldopen and Idclose(3X) are designed to work in concert. 
Ldclose will return FAILURE only when TYPE(Idptr) is 
the archive magic number and there is another file in the 
archive to be processed. Only then should [dopen be 
called with the current value of Idptr. In all other cases, 
in particular whenever a new filename is opened, ldopen 
should be called with a NULL Idptr argument. 


The following is a prototype for the use of /dopen and 
Idclose (3X). 


FILES 


LDOPEN (3X) 


/* for each filename to be processed */ 
ldptr = NULL; 
do 


{ 


if ( (Idptr = Idopen(filename, Idptr)) !== NULL ) 


/* check magic number */ 
/* process the file */ 


} while (ee == FAILURE ); 


If the value of oldptr is not NULL, Idaopen will open 
filename anew and allocate and initialize a new LDFILE 
structure, copying the TYPE, OFFSET, and HEADER 
fields from oldptr. Ldaopen returns a pointer to the new 
LDFILE structure. This new pointer is independent of 
the old pointer, oldptr. The two pointers may be used 
concurrently to read separate parts of the object file. 
For example, one pointer may be used to step 
sequentially through the relocation information, while 
the other is used to read indexed symbol table entries. 


Both Idopen and Idaopen open filename for reading. 
Both functions return NULL if filename cannot be 
opened, or if memory for the LDFILE structure cannot 
be allocated. A successful open does not insure that the 
ie file is a common object file or an archived object 
ile. 


The program must be loaded with the object file access 
routine library libld.a. 


/usr/lib/libld.a 


SEE ALSO 


fopen(3S), ldclose(3X), ldfen(4). 


NAME 


LDRSEEK (3X) 


\drseek, Idnrseek — seek to relocation entries of a section 
of a common object file 


SYNOPSIS 


#include <stdio.h> 
#finclude <filehdr.h> 
#include <Idfen.h> 


int Idrseek (Idptr, sectindx) 
LDFILE *#ldptr; 
unsigned short sectindx; 


int ldnrseek (idptr, sectname) 
LDFILE *ldptr; 
char *sectname; 


DESCRIPTION 


FILES 


Ldrseek seeks to the relocation entries of the section 
specified by sectindz of the common object file currently 
associated with Idptr. 


Ldnrseek seeks to the relocation entries of the section 
specified by sectname. 


Ldrseek and Idnrseek return SUCCESS or FAILURE. 
Ldrseek will fail if sectindz is greater than the number of 
sections in the object file; [dnrseek will fail if there is no 
section mame corresponding with sectname. Either 
function will fail if the specified section has no relocation 
entries or if it cannot seek to the specified relocation 
entries. 


Note that the first section has an index of one. 


The program must be loaded with the object file access 
routine library libld.a. 


/usr/lib/libld.a 


SEE ALSO 


Idclose(3X), ldopen(3X), Idshread(3X), Idfcn(4). 


LDSHREAD (3X) 


NAME 
Idshread, Idnshread — read an indexed/named section 
header of a common object file 

SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <scnhdr.h> 
#include <Idfcn.h> 
int Idshread (Idptr, sectindx, secthead) 
LDFILE *ldptr; 
unsigned short sectindx; 
SCNHDR *secthead; 
int Idnshread (Idptr, sectname, secthead) 
LDFILE *ldptr; 
char *sectname; 
SCNHDR *secthead; 

DESCRIPTION 
Ldshread reads the section header specified by sectindz 
of the common object file currently associated with Idptr 
into the area of memory beginning at secthead. 
Ldnshread reads the section header specified by sectname 
into the area of memory beginning at secthead. 
Ldshread and Idnshread return SUCCESS or FAILURE. 
Ldshread will fail if sectindz is greater than the number 
of sections in the object file; Idnshread will fail if there is 
no section name corresponding with sectname. Either 
function will fail if it cannot read the specified section 
header. 
Note that the first section header has an index of one. 
The program must be loaded with the object file access 
routine library libld.a. 

FILES 
/usr/lib/libld.a 

SEE ALSO 


Idclose(3X), ldopen(3X), Idfen(4). 


NAME 


LDSSEEK (3X) 


Idsseek, Idnsseek — seek to an indexed/named section of 
a common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfen.-h> 

int Idsseek (Idptr, sectindx) 
LDFILE *ldptr; 

unsigned short sectindx; 

int Idnsseek (Idptr, sectname) 
LDFILE +#ldptr; 

char *sectname; 


DESCRIPTION 


FILES 


Ldsseek seeks to the section specified by sectindz of the 
common object file currently associated with Idptr. 


Ldnsseek seeks to the section specified by sectname. 


Ldsseek and Idnsseek return SUCCESS or FAILURE. 
Ldsseek will fail if sectindz is greater than the number of 
sections in the object file; [dnsseek will fail if there is no 
section name corresponding with sectname. Either 
function will fail if there is no section data for the 
specified section or if it cannot seek to the specified 
section. 


Note that the first section has an index of one. 


The program must be loaded with the object file access 
routine library libld.a. 


/usr/lib/libld.a 


SEE ALSO 


Idclose(3X), ldopen(3X), Idshread(3X), Idfen(4). 


~~ 


NAME 


LDTBINDEX (3X) 


ldtbindex — compute the index of a symbol table entry 
of a common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <ldfen.h> 


long Idtbindex (Idptr) 
LDFILE +*ldptr; 


DESCRIPTION 


FILES 


Ldtbindez returns the (long) index of the symbol table 
entry at the current position of the common object file 
associated with Idptr. 


The index returned by Idtbindez may be used in 
subsequent calls to Idtbread(3X). However, since 
Idtbindex returns the index of the symbol table entry 
that begins at the current position of the object file, if 
Idtbindez is called immediately after a particular symbol 
table entry has been read, it will return the index of the 
next entry. 


Ldtbindez will fail if there are no symbols in the object 
file, or if the object file is not positioned at the 
beginning of a symbol table entry. 


Note that the first symbol in the symbol table has an 
index of zero. 


The program must be loaded with the object file access 
routine library libld.a. 


/usr/lib/libld.a 


SEE ALSO 


Idclose(3X), Idopen(3X), Idtbread(3X), Idtbseek(3X), 
Idfen(4). 


LDTBREAD ( 3X) 


NAME 
Idtbread -— read an indexed symbol table entry of a 
common object file 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <Idfcen.h> 


int Idtbread (ldptr, symindex, symbol) 
LDFILE *ldptr; 
long symindex; 
SYMENT *symbol; 
DESCRIPTION 
Ldtbread reads the symbol table entry specified by 
symindez of the common object file currently associated 
with Idptr into the area of memory beginning at symbol. 


Ldtbread returns SUCCESS or FAILURE. Ldtbread will 
fail if symindez is greater than the number of symbols in 
the object file, or if it cannot read the specified symbol 
table entry. 


Note that the first symbol in the symbol table has an 
index of zero. 


The program must be loaded with the object file access 
routine library libld.a. 
FILES 
/usr/lib/libld.a 
SEE ALSO 
Idclose(3X), Idopen(3X), ldtbseek(3X), ldfen(4). 


LDTBSEEK (3X) 


NAME 
Idtbseek — seek to the symbol table of a common object 
file 
SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <Idfen.h> 
int Idtbseek (Idptr) 
LDFILE +*ldptr; 
DESCRIPTION 
Ldtbseek seeks to the symbol table of the object file 
currently associated with /dptr. 


Ldtbseek returns SUCCESS or FAILURE. Ldtbseek will 
fail if the symbol table has been stripped from the object 
file, or if it cannot seek to the symbol table. 


The program must be loaded with the object file access 
routine library libld.a. 
FILES 
/usr/lib/libld.a 
SEE ALSO 
Idclose(3X), Idopen(3X), Idtbread(3X), Idfen(4). 


NAME 


LIBDEV (3X) 


libdev — manipulate Volume Home Blocks (VHB) 


SYNOPSIS 


#include <sys/gdisk.h> 


struct 


vhbd *vhbd; 


short sl, “slp; 


char 


* 
int fd; 


s, *device; 


int gdstrk(vhbd, sl 
int gdftrk(vhbd, sl 


int gdnsec(vhbd, 5 


int gdnsze(vhbd) 
int isdisk(fd) 


struct 


vhbd “*readvhb(s, sl) 


struct vhbd wrendvEe Ay 


struct 


char *adevname(fd) 
char *bdevname 


vhbd *freadvhb(fd, sl) 
s) 


int dismnt(fd) 

char *gdname(s, =P) 
char *fgdname(fd, slp) 
int gdniblk(fd) 


DESCRIPTION 


In each of the above subroutines the arguments denote: 


vhbd 


sl 
slp 


device 


fd 


A pointer to a disk volume home block, as 
returned by readvhb, sreadvhb or freadvhb. 


Slice number on the drive. 


Pointer to a slice number. This argument is 
actually used by the subroutine to return a slice 
number. 


The name of a special file in /dev/rdsk. This 
filename is used to obtain a file descriptor to 
access a VHB. The name need not be for slice 
zero of the disk. 


The name of a special file in /dev/rdsk. This 
filename is used to obtain a file descriptor to 
access a VHB. The name must be for slice zero 
of a disk. 


Open file descriptor for slice zero of a disk. 


The subroutines in /usr/lib/libdev.a form a device and 
machine independent interface to the VHB of CTIX 


disks. 
below. 


The function of each subroutine is described 


FILES 
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Gdnsee returns the number of sectors in slice s/ of the 


VHB indicated by vhbd. 


Gdstrk returns the starting track of slice sl of the VHB 
pointed to by vhbd. 


Gdftrk returns 1 if slice sl of the VHB pointed to by vhbd 
extends to the end of the disk. 


Gdnszc returns the number of sectors per cylinder. 


Isdisk returns 1 if the file descriptor fd is opened to a 
spectal disk device. 


Readvhb, Sreadvhb, and Freadvhb return a pointer to a 
VHB for the device described by their arguments. 


Adevname returns the character device name for the disk 
drive that the file descriptor fd is opened to. 


Bdevname returns the block device name for the disk 
drive that the string s names. The filename S may be 
either for any slice on either a raw or a block device. 


Dismnt exercises the GDDISMNT ioctl call for the disk 
drive that the file descriptor fd is opened to. 


Gdname returns the file name for the character special 
slice zero of a disk that the filename s name a slice of. 
The value pointed to by slp is set to the slice number of 
the filename s. Fgdname performs as does gdname, but 
uses the file descriptor fd instead of the filename s. 


Gdnlblk returns the number of logical blocks in the slice 
that the file descriptor fd is opened to. 


/dev/rdsk/c?d?s? 
/dev /dsk /c?d?s? 
/usr/lib/libdev.a 


SEE ALSO 


iv(1) disk(7). 


NAME 


LOCKF (3C) 


lockf — record locking on files 


SYNOPSIS 


# include <unistd.h> 


lockf (fildes, function, size) 
long size; 
int fildes, function; 


DESCRIPTION 


The lockf call will allow sections of a file to be locked 
(advisory write locks). (Mandatory or enforcement mode 
record locks are not currently available.) Locking calls 
from other processes which attempt to lock the locked 
file section will either return an error value or be put to 
sleep until the resource becomes unlocked. All the locks 
for a process are removed when the process terminates. 
[See fenti(2) for more information about record locking.| 


Fildes is an open file descriptor. The file descriptor must 
have O_WRONLY or O_RDWR permission in order to 
establish lock with this function call. 


Functton is a control value which specifies the action to 
be taken. The permissible values for function are 
defined in <unistd.h> as follows: 


#define F_ULOCK 0 

/* Unlock a previously locked section */ 
#define FLOCK 1 

/* Lock a section for exclusive use */ 
#define F_TLOCK 2 

/* Test and lock a section for exclusive use */ 
#define F_TEST 3 

/* Test section for other processes locks */ 


All other values of function are reserved for future 
extensions and will result in an error return if not 
implemented. 


F_TEST is used to detect if a lock by another process is 
present on the specified section. F_LOCK and F_TLOCK 
both lock a section of a file if the section is available. 
F_UNLOCK removes locks from a section of the file. 


Size is the number of contiguous bytes to be locked or 
unlocked. The resource to be locked starts at the 
current offset in the file and extends forward for a 
positive size and backward for a negative size. If size is 
zero, the section from the current offset through the 
largest file offset is locked (ie., from the current offset 
through the present or any future end-of-file). An area 


om 
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need not be allocated to the file in order to be locked, as 
such locks may exist past the end-of-file. 


The sections locked with F_LLOCK or F_TLOCK may, in 
whole or in part, contain or be contained by a previously 
locked section for the same process. When this occurs, 
or if adjacent sections occur, the sections are combined 
into a single section. If the request requires that a new 
element be added to the table of active locks and this 
table is already full, an error is returned, and the new 
section is not locked. 


F_LOCK and F_TLOCK requests differ only by the action 
taken if the resource is not available. F_LOCK will cause 
the calling process to sleep until the resource is available. 
F_TLOCK will cause the function to return a —1 and set 
errno to [EACCESS] error if the section is already locked 
by another process. 


F_ULOCK requests may, in whole or in part, release one 
or more locked sections controlled by the process. When 
sections are not fully released, the remaining sections are 
still locked by the process. Releasing the center section 
of a locked section requires an additional element in the 
table of active locks. If this table is full, an [EDEADLK] 
error is returned and the requested section is not 
released. 


A potential for deadlock occurs if a process controlling a 
locked resource is put to sleep by accessing another 
process’s locked resource. Thus calls to lock or fentl scan 
for a deadlock prior to sleeping on a locked resource. An 
error return is made if sleeping on the locked resource 
would cause a deadlock. 


Sleeping on a resource is interrupted with any signal. 
The alarm(2) command may be used to provide a 
timeout facility in applications which require this 


facility. 
ERRORS 

The lockf utility will fail if one or more of the following 

are true: 

[EBADF] Fildes is not a valid open descriptor. 

[EACCESS] Cmd is F_TLOCK or F_TEST and the 
section is already locked by another 
process. 

[EDEADLK] Cmd is F_LLOCK or F_TLOCK and a 


deadlock would occur. Also the cmd is 
either of the above or F_ULOCK and 
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the number of entries in the lock table 
would exceed the number allocated on 
the system. (Note that this differs from 
EDEADLOCK.) 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


CAVEATS 
Unexpected results may occur in processes that do 
buffering in the user address space. The process may 
later read/write data which is/was locked. The standard 
I/O package is the most common source of unexpected 
buffering. 


SEE ALSO 
close(2), creat(2), fcntl(2), intro(2), open(2), read(2), 
write(2). 
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LOGNAME( 3X) 


NAME 

logname — return login name of user 
SYNOPSIS 

char *logname( ) 
DESCRIPTION 


Logname returns a pointer to the null-terminated login 
name; it extracts the $LOGNAME variable from the 
user’s environment. 

This routine is kept in /lib/libPW.a. 


FILES 
/etc/profile 
/usr/lib/libPW.a 
SEE ALSO 
env(1), login(1), profile(4), environ(5). 
BUGS 
The return values point to static data whose content is 
overwritten by each call. 
This method of determining a login name is subject to 
forgery. 


LSEARCH (3C) 


NAME 
Isearch, Ifind - linear search and update 


SYNOPSIS 
#include <stdio.h> 
#include <search.h> 


char *lsearch ((char *)key, (char *)base, nelp, 
sizeof(*key), compar) 

unsigned *nelp; 

int (*compar)( ); 


char ‘*lfind ((char *)key, (char *)base, nelp, 
sizeof(*key), compar) 

unsigned *nelp; 

int (*compar)( ); 


DESCRIPTION 

Lsearch is a linear search routine generalized from 
Knuth (6.1) Algorithm S. It returns a pointer into a 
table indicating where a datum may be found. If the 
datum does not occur, it is added at the end of the table. 
Key points to the datum to be sought in the table. 
Base points to the first element in the table. Nelp 
points to an integer containing the current number of 
elements in the table. The integer is incremented if the 
datum is added to the table. Compar is the name of 
the comparison function which the user must supply 
(stremp, for example). It is called with two arguments 
that point to the elements being compared. The 
function must return zero if the elements are equal and 
non-zero otherwise. 


Lfind is the same as Isearch except that if the datum is 
not found, it is not added to the table. Instead, a NULL 
pointer is returned. 


NOTES 
The pointers to the key and the element at the base of 
the table should be of type pointer-to-element, and cast 
to type pointer-to-character. 
The comparison function need not compare every byte, 
so arbitrary data may be contained in the elements in 
addition to the values being compared. 
Although declared as type pointer-to-character, the value 
returned should be cast into type pointer-to-element. 


EXAMPLE 
This fragment will read in < TABSIZE strings of length 
< ELSIZE and store them in a table, eliminating 
duplicates. 
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#include <stdio.h> 
#include <search.h> 


#define TABSIZE 50 
#define ELSIZE 120 


char line[ELSIZE], tab{TABSIZE][ELSIZE], 
+lsearch( ); 

unsigned nel = 0; 

int stremp( ); 


while (fgets(line, ELSIZE, stdin) != NULL && 
nel < TABSIZE) 

(void) Isearch(line, (char *)tab, &nel, 
ELSIZE, stremp); 


SEE ALSO 


bsearch(3C), hsearch(3C), tsearch(3C). 


DIAGNOSTICS 


BUGS 


If the searched for datum is found, both lsearch and 
lfind return a pointer to it. Otherwise, [find returns 
NULL and lIsearch returns a pointer to the newly added 
element. 


Undefined results can occur if there is not enough room 
in the table to add a new item. 


NAME 


MALLOC(3C) 


malloc, free, realloc, calloc - main memory allocator 


SYNOPSIS 


char *malloc (size) 
unsigned size; 

void free (ptr) 

char *ptr; 

char *realloc (ptr, size) 
char *ptr; 

unsigned size; 

char *calloc (nelem, elsize) 
unsigned nelem, elsize; 


DESCRIPTION 


Malloc and free provide a simple general-purpose 
memory allocation package. Malloc returns a pointer to 
a block of at least stze bytes suitably aligned for any 
use. 


The argument to free is a pointer to a block previously 
allocated by malloc; after free is performed this space is 
made available for further allocation, but its contents are 
left undisturbed. 


Undefined results will occur if the space assigned by 
malloc is overrun or if some random number is handed 
to free. 


Malloc allocates the first big enough contiguous reach of 
free space found in a circular search from the last block 
allocated or freed, coalescing adjacent free blocks as it 
searches. It calls sbrk (see brk(2)) to get more memory 
from the system when there is no suitable space already 
free. 


Realloc changes the size of the block pointed to by ptr 
to size bytes and returns a pointer to the (possibly 
moved) block. The contents will be unchanged up to the 
lesser of the new and old sizes. If no free block of size 
bytes is available in the storage arena, then realloc will 
ask malloc to enlarge the arena by size bytes and will 
then move the data to the new space. 


Realloc also works if ptr points to a block freed since the 
last call of malloc, realloc, or calloc; thus sequences of 
free, malloc and realloc can exploit the search strategy 
of malloc to do storage compaction. 


Calloc allocates space for an array of nelem elements of 
size elsize. The space is initialized to zeros. 
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Each of the allocation routines returns a pointer to space 
suitably aligned (after possible pointer coercion) for 
storage of any type of object. 


SEE ALSO 

brk(2), malloc(3X). 

DIAGNOSTICS 
Malloc, realloe and calloe return a NULL pointer if there 
is no available memory or if the arena has been 
detectably corrupted by storing outside the bounds of a 
block. When this happens the block pointed to by ptr 
may be destroyed. 

NOTE 
Search time increases when many objects have been 
allocated; that is, if a program allocates but never frees, 
then each successive allocation takes longer. For an 
alternate, more flexible implementation, see malloc(3X). 


NAME 


MALLOC (3X) 


malloc, free, realloc, calloc, mallopt, mallinfo — fast 
main memory allocator 


SYNOPSIS 


#include <malloc.h> 
char *malloc (size) 
unsigned size; 

void free (ptr) 

char *ptr; 

char *realloc (ptr, size) 
char *ptr; 

unsigned size; 

char *calloc (nelem, elsize) 
unsigned nelem, elsize; 


int mallopt (cmd, value) 
int cmd, value; 


struct mallinfo mallinfo (max) 
int max; 


DESCRIPTION 


Malloc and free provide a simple general-purpose 
memory allocation package, which runs considerably 
faster than the malloc(3C) package. It is found in the 
library “malloc’’, and is loaded if the option ‘“‘—lmalloc”’ 
is used with ce(1) or /d(1). 


Malloc returns a pointer to a block of at least stze bytes 
suitably aligned for any use. 


The argument to free is a pointer to a block previously 
allocated by malloc; after free is performed this space is 
made available for further allocation, and its contents 
have been destroyed (but see mallopt below for a way to 
change this behavior). 


Undefined results will occur if the space assigned by 
malloc is overrun or if some random number is handed 
to free. 


Realloe changes the size of the block pointed to by ptr 
to size bytes and returns a pointer to the (possibly 
moved) block. The contents will be unchanged up to the 
lesser of the new and old sizes. 


Calloc allocates space for an array of nelem elements of 
size elsize. The space is initialized to zeros. 


Mallopt provides for control over the allocation 
algorithm. The available values for emd are: 
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M_MXFAST Set mazfast to value. The algorithm 
allocates all blocks below the size of 
mazfast in large groups and then doles 
them out very quickly. The default value 
for mazfast is 0. 


M_NLBLKS~ Set numilblks to value. The above 
mentioned ‘“‘large groups” each contain 
numlblks blocks. Numlblks must be 
greater than 0. The default value for 
numlblks is 100. 


M_GRAIN Set gratn to value. The sizes of all blocks 
smaller than mazfast are considered to be 
rounded up to the nearest multiple of 
grain. Gratn must be greater than 0. 
The default value of gratin is the smallest 
number of bytes which will allow 
alignment of any data type. Value will be 
rounded up to a multiple of the default 
when grain is set. 


M_KEEP Preserve data in a freed block until the 
next malloc, realloc, or calloc. This 
option is provided only for compatibility 
with the old version of malloc and is not 
recommended. 


These values are defined in the < malloc.h > header file. 


Mallopt may be called repeatedly, but may not be called 
after the first small block is allocated. 


Mallinfo provides instrumentation describing space 
usage. It returns the structure: 


struct mallinfo { 


int arena; /* total space in arena * 

int ordblks; = /* number of ordinary blocks */ 

int smblks; /* number of small blocks */ 

int hblkhd; /* space in holding block headers */ 
int hblks; /* number of holding blocks */ 

int usmblks; /* space in small blocks in use */ 
int fsmblks; —_/* space in free small blocks */ 


int uordblks; /* space in ordinary blocks in use */ 
int fordblks; /* space in free ordinary blocks */ 
int keepcost; /* space penalty if keep option */ 

} /* is used */ 


This structure is defined in the <malloc.h > header file. 


Each of the allocation routines returns a pointer to space 
suitably aligned (after possible pointer coercion) for 
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storage of any type of object. 


SEE ALSO 
brk(2), malloc(3C). 


DIAGNOSTICS 
Malloc, realloc and calloc return a NULL pointer if there 
is not enough available memory. When realloc returns 
NULL, the block pointed to by pér is left intact. If 
mallopt is called after any allocation or if emd or value 
are invalid, non-zero is returned. Otherwise, it returns 


zero. 

WARNINGS 
This package usually uses more data space than 
malloc (3C). 


The code size is also bigger than malloc(3C). 

Note that unlike malloc(3C), this package does not 
preserve the contents of a block when it is freed, unless 
the M_KEEP option of mallopt is used. 

Undocumented features of malloc(3C) have not been 
duplicated. 


—~ 


NAME 


MATHERR (3M) 


matherr — error-handling function 


SYNOPSIS 


#include <math.h> 


int matherr (x) 
struct exception *x; 


DESCRIPTION 


Matherr is invoked by functions in the Math Library 
when errors are detected. Users may define their own 
procedures for handling errors, by including a function 
named matherr in their programs. Matherr must be of 
the form described above. When an error occurs, a 
pointer to the exception structure z will be passed to the 
user-supplied matherr function. This structure, which is 
defined in the < math.h> header file, is as follows: 


struct exception { 
int type; 
char *name; 
double argl, arg2, retval; 
The element type is an integer describing the type of 
error that has occurred, from the following list of 
constants (defined in the header file): 


DOMAIN argument domain error 
SING argument singularity 
OVERFLOW overflow range error 
UNDERFLOW underflow range error 
TLOSS total loss of significance 
PLOSS partial loss of significance 


The element name points to a string containing the 
name of the function that incurred the error. The 
variables arg! and arg2 are the arguments with which 
the function was invoked. Retval is set to the default 
value that will be returned by the function unless the 
user’s matherr sets it to a different value. 


If the user’s matherr function returns non-zero, no error 
message will be printed, and errno will not be set. 


If matherr is not supplied by the user, the default error- 
handling procedures, described with the math functions 
involved, will be invoked upon error. These procedures 
are also summarized in the table below. In every case, 
errno is set to EDOM or ERANGE and the program 
continues. 
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EXAMPLE 
#include <math.h> 


int 


matherr(x) 
register struct exception *x; 


{ 


switch (x- >type) { 
case DOMAIN: 
/* change sqrt to return sqrt(—argl), not 0 */ 
if (!stremp(x— >name, “sqrt”)) { 
x- >retval = sqrt(—x- >argl); 
return (0); /* print message and set errno */ 


case SING: 
/* all other domain or sing errors, print message and abort */ 
fprintf(stderr, “domain error in %s\n”, x— >name); 
abort( ); 
case PLOSS: 
/* print detailed error message */ 
fprintf(stderr, "loss of significance in %s(%g) = %g\n", 
x- >name, x~ >argl, x- >retval); 
return (1); /* take no other action */ 


return (0); /* all other errors, execute default procedure */ 


type 


IBESSEL: 

vO, yl, yn (arg < 0) 
IEXP: 

Loa, LOG)10: 

(arg < 0) 

(arg = 0) 


ee 
eg ** non-int 


O ** non-pos 


MATHERR (3M) 


DOMAIN 


DEFAULT ERROR HANDLING PROCEDURES 


Types of Errors 


sING | OVERFLOW | UNDERFLOW 


[ems | OM | EDOM | BRANGE 


ERANGE 


M-H | - 7 7 


ABBREVIATIONS 
As much as possible of the value is returned. 
Message is printed (EDOM error). 
HUGE is returned. 
—HUGE is returned. 
HUGE or —HUGE is returned. 
0 is returned. 
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NAME 
memccpy, memchr, memcmp, memcpy, memset — 
memory operations 


SYNOPSIS 
#include <memory.h> 


char *memcecpy (sl, 52, ¢, n) 
char *sl, *s2; 
int c, n; 


char *memchr (s, ¢, n) 
char *s; 
int c, n; 


int mememp (s1, s2, n) 
char *s1, *s2; 
int n; 


char *memcpy (sl, s2, n) 
char *s1, *s2; 
int n; 


char *memset (s, c, n) 
char *s; 
int c, n; 


DESCRIPTION 
These functions operate as efficiently as possible on 
memory areas (arrays of characters bounded by a count, 
not terminated by a null character). They do not check 
for the overflow of any receiving memory area. 


Memccpy copies characters from memory area s2 into 
81, stopping after the first occurrence of character c has 
been copied, or after n characters have been copied, 
whichever comes first. It returns a pointer to the 
character after the copy of ¢ in 81, or a NULL pointer if 
ec was not found in the first n characters of 82. 


Memchr returns a pointer to the first occurrence of 
character ¢ in the first n characters of memory area s, 
or a NULL pointer if ¢ does not occur. 


Memcmp compares its arguments, looking at the first n 
characters only, and returns an integer less than, equal 
to, or greater than O, according as 8! is lexicographically 
less than, equal to, or greater than 82. 


Memcepy copies n characters from memory area 82 to sl. 
It returns 81. 


Memset sets the first n characters in memory area s to 
the value of character c. It returns s. 


— 


NOTE 


BUGS 
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For user convenience, all these functions are declared in 
the optional <memory.h> header file. 


Memcmp uses native character comparison, which is 
signed on some machines (including Convergent 
Technologies 68000-family processors) but not on others. 
Thus the sign of the value returned when one of the 
characters has its high-order bit set is implementation- 
dependent. ASCII values are always positive, so 
programs that compare only ASCII values are portable. 


Character movement is performed differently in different 
implementations. Thus, overlapping moves may yield 
surprises. 


MKTEMP (3C) 


NAME 
mktemp — make a unique file name 


SYNOPSIS 
char *mktemp (template) 
char *template; 


DESCRIPTION 
Mktemp replaces the contents of the string pointed to by 
template by a unique file name, and returns the address 
of template. The string in template should look like a 
file name with six trailing Xs; mktemp will replace the 
Xs with a letter and the current process ID. The letter 
will be chosen so that the resulting name does not 
duplicate an existing file. 

SEE ALSO 
getpid(2), tmpfile(3S), tmpnam(3S). 


BUGS 
It is possible to run out of letters. 
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NAME 
monitor — prepare execution profile 
SYNOPSIS 
— #include <mon.h> 


void monitor (lowpc, highpe, buffer, bufsize, nfunc) 
int (Clowes) ), (*highpce)(_ ); 

WORD *buffer; 

int bufsize, nfunc; 


DESCRIPTION 
An executable program created by ce —p automatically 
includes calls for monttor with default parameters; 
monitor needn’t be called explicitly except to gain fine 
control over profiling. 


Monitor is an interface to profil(2). Lowpe and highpe 
are the addresses of two functions; buffer is the address 
of a (user supplied) array of bufetze WORDs (defined in 
the <mon.h> header file). Monttor arranges to record 
a histogram of periodically sampled values of the 
program counter, and of counts of calls of certain 
functions, in the buffer. The lowest address sampled is 
that of lowpe and the highest is just below highpc. 
Lowpe may not equal 0 for this use of monttor. At most 
nfunc cali counts can be kept; only calls of functions 
compiled with the profiling option —p of cc(1) are 
recorded. (The C Library and Math Library supplied 
when cc —p is used also have call counts recorded.) 


For the results to be significant, especially where there 
are small, heavily used routines, it is suggested that the 
buffer be no more than a few times smaller than the 
range of locations sampled. 


To profile the entire program, it is sufficient to use 
extern etext; 


monitor ((int (*)())2, etext, buf, bufsize, nfunc); 
Etezt lies just above all the program text; see end(3C). 


To stop execution monitoring and write the results on 
the file mon.out, use 
monitor ((int (*)())0, 0, 0, 0, 0); 
Prof(1) can then be used to examine the results. 
“™~ FILES 
mon.out / 
/lib/libp/libe.a 
/lib /libp/libm.a 
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SEE ALSO 
ec(1), prof(1), profil(2), end(3C). 
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NAME 
nlist - get entries from name list 


SYNOPSIS 
#include <nlist.h> 


int nlist (file-name, nl) 
char *file-name; 
struct nlist *nl; 


DESCRIPTION 

Nlist examines the name list in the executable file whose 
name is pointed to by file-name, and selectively extracts 
a list of values and puts them in the array of nlist 
structures pointed to by nl. The name list ni consists of 
an array of structures containing names of variables, 
types and values. The list is terminated with a null 
name; that is, a null string is in the name position of the 
structure. Each variable name is looked up in the name 
list of the file. If the name is found, the type and value 
of the name are inserted in the next two fields. The 
type field will be set to 0 unless the file was compiled 
with the -g option. If the name is not found, both 
entries are set to 0. See a.out(4) for a discussion of the 
symbol table structure. 


This function is useful for examining the system name 
list kept in the file /unix. In this way programs can 
obtain system addresses that are up to date. 

NOTES 
The <nlist.h> header file is automatically included by 
<a.out.h> for compatability. However, if the only 
information needed from <a.out.h> is for use of nlist, 
then including <a.out.h> is’ discouraged. If 
<a.out.h> is included, the line ‘““##undef n_name”’ may 
need to follow it. 

SEE ALSO 
a.out(4). 

DIAGNOSTICS 
All value entries are set to 0 if the file cannot be read or 
if it does not contain a valid name list. 


Niet returns —1 upon error; otherwise it returns 0. 
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NAME 


OCURSE( 3X) 


ocurse — optimized screen functions 


SYNOPSIS 


#include <ocurse.h> 


DESCRIPTION 


FILES 


Ocurse is the old Berkeley curses library that uses 
termcap(4). 


These functions optimally update the screen. 


Each curses program begins by calling initser and ends 
by calling endwin. 


Before a program can change a screen, it must specify 
the changes. It stores changes in a variable of type 
WINDOW by calling curses functions with the variable 
as argument. Once the variable contains all the changes 
desired, the program calls wrefresh to write the changes 
to the screen. 


Most programs need only a single WINDOW variable. 
Ocurse provides a standard WINDOW variable for this 
case and a group of functions that operate on it. The 
variable is called stdser; its special functions have the 
same names as the general functions minus the initial w. 


/usr/include/ocurse.h header file 
/usr/lib/libocurse.a curses library 
/usr/lib/libtermcap.a termcap library, used by curses 


SEE ALSO 


Ken Arnold. Screen Updating and Cursor Movement 
Optimization: A Library Package. Berkeley, Calif.: 
University of California. 


stty(2), setenv(3), termcap(4). 


FUNCTIONS 
addch(ch) Add a character to stdscr. 
addstr(str) Add a string to stdscr. 
box(win,vert,hor) Draw a box around a window. 
ermode() Set cbreak mode. 
clear() Clear stdser. 
clearok(scr,boolf) Set clear flag for ser. 
clrtobot() Clear to bottom on stdser. 
clrtoeol( Clear to end of line on stdser. 
delch() Delete a character. 
deleteln() Delete a line. 
delwin(win) Delete win. 
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echo() 


endwin() 
erase( 

getch() 
getcap(name) 
getstr(str) 
gettmode() 
getyx(win,y,x) 
inch() 


initser( 
insch(c 

insertln() 
leaveok( win, boolf) 


Set echo mode. 

End window modes. 

Erase stdser. 

Get a char through sédser. 
Get terminal capability name. 
Get a string through stdscr. 
Get tty modes. 

Get (y,x) co-ordinates. 

Get char at current (y,x) 
ordinates. 

Initialize screens. 

Insert a char. 

Insert a line. 

Set leave flag for win. 


longname(termbuf,name) 


move(y,x) 


Get long name from termbuf. 
Move to (y,x) on stdser. 


mvcur(lasty,lastx ,newy ,newx) 


Actually move cursor. 


newwin(lines,cols, begin_y ,begin_x) 


nl() 


nocrmode() 

noecho() 

nonl() 

noraw() 
overlay(winl,win2) 
overwrite(winl,win2) 


printw(fmt,arg1 ,arg2,... 


aw() 


r 
refresh() 


resetty( 
savetty() 


scanw(fmt,argl,arg2,... 


scroll(win 
scrollok(win,boolf) 
setterm(name) 
standend 

standout 


Create a new window. 

Set newline mapping. 

Unset cbreak mode. 

Unset echo mode. 

Unset newline mapping. 

Unset raw mode. 

Overlay winl on win2. 
Overwrite winl on top of win2. 


hee on stdscr. 
Set raw mode. 


co- 


Make current screen look like 


stdscr. 
Reset tty flags to stored value. 
Stored current tty flags. 


a 


Scanf through stdser. 

Scroll win one line. 

Set scroll flag. 

Set term variables for name. 
End standout mode. 

Start standout mode. 


subwin(win,lines,cols,begin_y,begin_x) 


touchwin(win) 
unctri(ch) 
waddch(win,ch) 
waddstr(win,str) 


Create a subwindow. 
change all of wen. 
Printable version of ch. 
Add char to wtn. 

Add string to win. 
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wclear(win) Clear win. 
welrtobot(win) Clear to bottom of win. 
welrtoeol(win) Clear to end of line on win. 
wdelch(win,c) Delete char from wrn. 
wdeleteln(win) Delete line from win. 
werase(win) Erase win. 
wgetch(win) Get a char through win. 
wegetstr(win,str) Get a string through win. 
winch(win) Get char at current (y,x) in win. 
winsch(win,c) Insert char into win. 
winsertln(win) Insert line into win. 
wmove(win,y,x) Set current (y,x) co-ordinates on 
win. 


wprintw(win,fmt,argl,arg2,...) 
rintf on win. 
wrefresh(win) Make screen look like win. 
wscanw(win,fmt,arg1,arg2,...) 
Scanf through win. 
wstandend(win) End standout mode on win. 
wstandout(win) Start standout mode on win. 
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NAME 


PERROR (3C) 


perror, errno, sys_errlist, sys_nerr -— system error 
messages 


SYNOPSIS 


void perror (s) 
char *s; 


extern int errno; 
extern char *sys_errlist{ |; 
extern int sys_nerr; 


DESCRIPTION 


Perror produces a message on the standard error output, 
describing the last error encountered during a call to a 
system or library function. The argument string s is 
printed first, then a colon and a blank, then the message 
and a new-line. To be of most use, the argument string 
should include the name of the program that incurred 
the error. The error number is taken from the external 
variable errno, which is set when errors occur but not 
cleared when non-erroneous calls are made. 


To simplify variant formatting of messages, the array of 
message strings sys_errlist is provided; errno can be 
used as an index in this table to get the message string 
without the new-line. Sys_nerr is the largest message 
number provided for in the table; it should be checked 
because new error codes may be added to the system 
before they are added to the table. 


SEE ALSO 


intro(2). 
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NAME 

plot — graphics interface subroutines 
SYNOPSIS 

openpl () 

erase () 

label (s) 

char *s; 

line (x1, yl, x2, y2) 

int xl, yl, x2, y2; 

circle (x, y, r) 

int x, y, 33 

arc (x, y, x0, yO, x1, yl) 

int x, y, xO, yO, x1, yl; 

move (x, y) 

int x, y; 


cont (x, y) 
int x, y; 


point (x, y) 

int x, y; 

linemod (s) 

char *s; 

space (x0, yO, x1, y1) 
int x0, yO, x1, yl; 


closepl () 


DESCRIPTION 
These subroutines generate graphic output in a relatively 
device-independent manner. Space must be used before 
any of these functions to declare the amount of space 
necessary. See plot(4). Openp! must be used before any 
of the others to open the device for writing. Closepl 
flushes the output. 


Circle draws a circle of radius r with center at the point 
(z, y). 

Are draws an arc of a circle with center at the point (z, 
y) between the points (20, yO) and (z1, yl). 

String arguments to label and linemod are terminated by 
nulls and do not contain new-lines. 

See plot(4) for a description of the effect of the 
remaining functions. 


The library files listed below provide several flavors of 
these routines. 
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FILES 
/usr/lib/libplot.a produces output for fplot(1G) 
filters 
/usr/lib/lib300.a for DASI 300 
/usr/lib/lib300s.a for DASI 300s 
/usr/lib/lib450.a for DASI 450 
/usr/lib/lib4014.a for TEKTRONIX 4014 


WARNINGS 
In order to compile a program containing these functions 
in file.c it is necessary to use “‘cc file.c —Iplot”. 
In order to execute it, it is necessary to use “‘a.out | 
tplot’’. 
The above routines use <stdio.h>, which causes them 
to increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 


SEE ALSO 
graph(1G), stat(1G), tplot(1G), plot(4). 


NAME 


POPEN (3S) 


popen, pclose — initiate pipe to/from a process 


SYNOPSIS 


#include <stdio.h> 
FILE *popen (command, type) 
char *command, #type; 


int pclose (stream) 
FILE *stream; 


DESCRIPTION 


The arguments to popen are pointers to null-terminated 
strings containing, respectively, a shell command line 
and an I/O mode, either r for reading or w for writing. 
Popen creates a pipe between the calling program and 
the command to be executed. The value returned is a 
stream pointer such that one can write to the standard 
input of the command, if the I/O mode is w, by writing 
to the file stream; and one can read from the standard 
output of the command, if the I/O mode is r, by reading 
from the file stream. 


A stream opened by popen should be closed by pelose, 
which waits for the associated process to terminate and 
returns the exit status of the command. 


Because open files are shared, a type r command may be 
used as an input filter and a type w as an output filter. 


SEE ALSO 


pipe(2), wait(2), fclose(3S), fopen(3S), system(38S). 


DIAGNOSTICS 


BUGS 


Popen returns a NULL pointer if files or processes cannot 
be created, or if the shell cannot be accessed. 


Pclose returns —1 if stream is not associated with a 
““popen ed” command. 


If the original and “popened’’ processes concurrently 
read or write a common file, neither should use buffered 
I/O, because the buffering gets all mixed up. Problems 
with an output filter may be forestalled by careful buffer 
flushing, e.g. with fflush; see felose(3S). 
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NAME 

printf, fprintf, sprintf — print formatted output 
SYNOPSIS 

#include <stdio.h> 


int printf (format [| , arg |... ) 
char *format; 
int fprintf (stream, format [, arg]... ) 


FILE *stream; 
char *format; 


int sprintf (s, format [, arg]... ) 
char *s, format; 


DESCRIPTION 

Printf places output on the standard output stream 
stdout. Fprintf places output on the named output 
stream. Sprintf places ‘“‘output,’”’ followed by the null 
character (\O), in consecutive bytes starting at *s; it is 
the user’s responsibility to ensure that enough storage is 
available. Each function returns the number of 
characters transmitted (not including the \O in the case 
of sprintf), or a negative value if an output error was 
encountered. 


Each of these functions converts, formats, and prints its 
args under control of the format. The format is a 
character string that contains two types of objects: plain 
characters, which are simply copied to the output 
stream, and conversion specifications, each of which 
results in fetching of zero or more args. The results are 
undefined if there are insufficient args for the format. If 
the format is exhausted while args remain, the excess 
args are simply ignored. 


Each conversion specification is introduced by the 
character %. After the %, the following appear in 
sequence: 


Zero or more flags, which modify the meaning of 
the conversion specification. 


An optional decimal digit string specifying a 
minimum field width. If the converted value has 
fewer characters than the field width, it will be 
padded on the left (or right, if the left- 
adjustment flag ‘—’, described below, has been 
given) to the field width. If the field width for 
an s conversion is preceded by a 0, the string is 
right adjusted with zero-padding on the left. 


A precision that gives the minimum number of 
digits to appear for the d, o, u, x, or X 


Es 
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conversions, the number of digits to appear after 
the decimal point for the e and f conversions, 
the maximum number of significant digits for 
the g conversion, or the maximum number of 
characters to be printed from a string in 8 
conversion. The precision takes the form of a 
period (.) followed by a decimal digit string; a 
null digit string is treated as zero. 


An optional | (ell) specifying that a following d, 
o, u, x, or X conversion character applies to a 
long integer arg. A I before any other 
conversion character is ignored. 


A character that indicates the type of conversion 
to be applied. 


A field width or precision may be indicated by an 
asterisk (*) instead of a digit string. In this case, an 
integer arg supplies the field width or precision. The 
arg that is actually converted is not fetched until the 
conversion letter is seen, so the args specifying field 
width or precision must appear before the arg (if any) to 
be converted. 


The flag characters and their meanings are: 


blank 


The result of the conversion will be left- 
justified within the field. 

The result of a signed conversion will always 
begin with a sign (+ or —). 

If the first character of a signed conversion is 
not a sign, a blank will be prefixed to the 
result. This implies that if the blank and + 
flags both appear, the blank flag will be 
ignored. 

This flag specifies that the value is to be 
converted to an “alternate form.’”’ For c, d, 
s, and u conversions, the flag has no effect. 
For o conversion, it increases the precision to 
force the first digit of the result to be a zero. 
For x or X conversion, a non-zero result will 
have Ox or OX prefixed to it. Fore, E, f, g, 
and G conversions, the result will always 
contain a decimal point, even if no digits 
follow the point (normally, a decimal point 
appears in the result of these conversions only 
if a digit follows it), For g and G 
conversions, trailing zeroes will not be 
removed from the result (which they 
normally are). 
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The conversion characters and their meanings are: 


d,o,u,x,x The integer arg is converted to signed 


e,E 


decimal, unsigned octal, decimal, or 
hexadecimal notation (x and X), respectively; 
the letters abcdef are used for x conversion 
and the letters ABCDEF for X conversion. 
The precision specifies the minimum number 
of digits to appear; if the value being 
converted can be represented in fewer digits, 
it will be expanded with leading zeroes. (For 
compatibility with older versions, padding 
with leading zeroes may alternatively be 
specified by prepending a zero to the field 
width. This does not imply an octal value for 
the field width.) The default precision is 1. 
The result of converting a zero value with a 
precision of zero is a null string. 

The float or double arg is converted to 
decimal notation in the style “(—|]ddd.ddd,” 
where the number of digits after the decimal 
point is equal to the precision specification. 
If the precision is missing, six digits are 
output; if the precision is explicitly 0, no 
decimal point appears. 

The float or double arg is converted in the 
style ‘{—]d.dddet+dd,” where there is one 
digit before the decimal point and _ the 
number of digits after it is equal to the 
precision; when the precision is missing, six 
digits are produced; if the precision is zero, 
no decimal point appears. The E format 
code will produce a number with E instead of 
e introducing the exponent. The exponent 
always contains at least two digits. 

The float or double arg is printed in style f 
or e (or in style E in the case of a G format 
code), with the precision specifying the 
number of significant digits. The style used 
depends on the value converted: style e will 
be used only if the exponent resulting from 
the conversion is less than —4 or greater than 
the precision. Trailing zeroes are removed 
from the result; a decimal point appears only 
if it is followed by a digit. 

The character arg is printed. 

The arg is taken to be a string (character 
pointer) and characters from the string are 
printed until a null character (\0) is 
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encountered or the number of characters 
indicated by the precision specification is 
reached. If the precision is missing, it is 
taken to be infinite, so all characters up to 
the first null character are printed. A NULL 
value for arg will yield undefined results. 

% Print a %; no argument is converted. 


In no case does a non-existent or small field width cause 
truncation of a field; if the result of a conversion is wider 
than the field width, the field is simply expanded to 
contain the conversion result. Characters generated by 
printf and fprintf are printed as if putc(3S) had been 
called. 


EXAMPLES 
To print a date and time in the form ‘‘Sunday, July 3, 
10:02,”” where weekday and month are pointers to null- 
terminated strings: 
printf(”%s, %s %d, %d:%.2d", 
weekday, month, day, hour, min); 


To print m to 5 decimal places: 
printf(”"pi = %.5f", 4 * atan(1.0)); 


SEE ALSO 
ecvt(3C), putc(3S), scanf(3S), stdio(3S). 
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NAME 
putc, putchar, fputc, putw — put character or word on a 
stream 
SYNOPSIS 
#include <stdio.h> 
int pute (c, stream) 
int ¢; 
FILE *stream; 
int putchar (c) 
int ¢; 
int fpute (c, stream) 
int ¢; 
FILE *stream; 
int putw (w, stream) 
int w; 
FILE *stream; 
DESCRIPTION 


Pute writes the character ¢ onto the output stream (at 
the position where the file pointer, if defined, is 
pointing). Putchar(c) is defined as pute(c, stdout). 
Pute and putchar are macros. 


Fpute behaves like putc, but is a function rather than a 
macro. Fpute runs more slowly than pute, but it takes 
less space per invocation and its name can be passed as 
an argument to a function. 


Putw writes the word (i.e. integer) w to the output 
stream (at the position at which the file pointer, if 
defined, is pointing). The size of a word is the size of an 
integer and varies from machine to machine. Putw 
neither assumes nor causes special alignment in the file. 


Output streams, with the exception of the standard error 
stream stderr, are by default buffered if the output 
refers to a file and line-buffered if the output refers to a 
terminal. The standard error output stream stderr is by 
default unbuffered, but use of freopen (see fopen(3S)) 
will cause it to become buffered or line-buffered. When 
an output stream is unbuffered, information is queued 
for writing on the destination file or terminal as soon as 
written; when it is buffered, many characters are saved 
up and written as a block. When it is line-buffered, each 
line of output is queued for writing on the destination 
terminal as soon as the line is completed (that is, as soon 
as a new-line character is written or terminal input is 
requested). Setbuf(3S) may be used to change the 
stream’s buffering strategy. 


= 
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SEE ALSO 


fclose(3S), ferror(3S), fopen(3S), fread(3S), printf(3S), 
puts(3S), acy ) (3S), ( 


DIAGNOSTICS 


BUGS 


On success, these functions each return the value they 
have written. On failure, they return the constant EOF. 
This will occur if the file stream is not open for writing 
or if the output file cannot be grown. Because EOF is a 
valid integer, ferror(3S) should be used to detect putw 
errors. 


Because it is implemented as a macro, putc treats 
incorrectly a stream argument with side effects. In 
particular, pute(c, *f++); doesn’t work sensibly. Fputc 
should be used instead. 

Because of possible differences in word length and byte 
ordering, files written using putw are machine- 
dependent, and may not be read using getw on a 
different processor. 


PUTENV(3C) 


putenv — change or add value to environment 


SYNOPSIS 


int putenv (string) 
char *string; 


DESCRIPTION 


String points to a string of the form ‘‘name=value.”’ 
Putenv makes the value of the environment variable 
name equal to value by altering an existing variable or 
creating a new one. In either case, the string pointed to 
by string becomes part of the environment, so altering 
the string will change the environment. The space used 
by string is no longer used once a new string-defining 
name is passed to putenv. 


DIAGNOSTICS 


Putenv returns non-zero if it was unable to obtain 
enough space via malloc for an expanded environment, 
otherwise zero. 


SEE ALSO 


exec(2), getenv(3C), malloc(3C), environ(5). 


WARNINGS 


Putenv manipulates the environment pointed to by 
environ, and can be used in conjunction with getenv. 
However, envp (the third argument to main) is not 
changed. 

This routine uses malloc(3C) to enlarge the environment. 
After putenv is called, environmental variables are not in 
alphabetical order. 

A potential error is to call putenv with an automatic 
variable as the argument, then exit the calling function 
while string is still part of the environment. 
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NAME 
putpwent — write password file entry 


SYNOPSIS 
#include <pwd.h> 


int putpwent (p, f) 
struct passwd *p; 
FILE *f; 


DESCRIPTION 
Putpwent is the inverse of getpwent(3C). Given a 
pointer to a passwd structure created by getpwent (or 
getpwutd or getpwnam), putpwent writes a line on the 
stream f, which matches the format of /ete/passwd. 


DIAGNOSTICS 
Putpwent returns non-zero if an error was detected 
during its operation, otherwise zero. 


SEE ALSO 
getpwent(3C). 

WARNING 
The above routine uses <stdio.h>, which causes it to 
increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 
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NAME 
puts, fputs — put a string on a stream 


SYNOPSIS 
#include <stdio.h> 
int puts (s) 
char *8; 
int fputs (s, stream) 
char *s; 
FILE *stream; 
DESCRIPTION 
Puts writes the null-terminated string pointed to by s, 
followed by a new-line character, to the standard output 
stream stdout. 


Fputs writes the null-terminated string pointed to by s 
to the named output stream. 


Neither function writes the terminating null character. 


DIAGNOSTICS 
Both routines return EOF on error. This will happen if 
the routines try to write on a file that has not been 
opened for writing. 
SEE ALSO 
ferror(3S), fopen(3S), fread(3S), printf(3S), putc(3S). 
NOTES 
Puts appends a new-line character while fputs does not. 
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NAME 
qsort — quicker sort 


SYNOPSIS 
void qsort ((char *) base, nel, sizeof (*base), 
compar) 
unsigned nel; 
int fecompae yt )3 


DESCRIPTION 
Qsort is an implementation of the quicker-sort 
algorithm. It sorts a table of data in place. 


Base points to the element at the base of the table. Nel 
is the number of elements in the table. Compar is the 
name of the comparison function, which is called with 
two arguments that point to the elements being 
compared. The function must return an integer less 
than, equal to, or greater than zero. 


NOTES 

The pointer to the base of the table should be of type 
pointer-to-element, and cast to type pointer-to-character. 
The comparison function need not compare every byte, 
so arbitrary data may be contained in the elements in 
addition to the values being compared. 

The order in the output of the two items which compare 
as equal is unpredictable. 


SEE ALSO 
sort(1), bsearch(3C), lsearch(3C), string(3C). 


NAME 


RAND (3C) 


rand, srand — simple random-number generator 


SYNOPSIS 


int rand ( ) 


void srand (seed) 
unsigned seed; 


DESCRIPTION 


NOTE 


Rand uses a multiplicative fpngruential random-number 
generator with period 2 that returns successive 
pseudo-random numbers in the range from 0 to 2°°-1 


Srand can be called at any time to reset the random- 
number generator to a random starting point. The 
generator is initially seeded with a value of 1. 


The spectral properties of rand leave a great deal to be 
desired. Drand48(3C) provides a much better, though 
more elaborate, random-number generator. 


SEE ALSO 


drand48(3C). 


NAME 


RCMD(3N) 


remd, rresvport, ruserok -— routines for returning a 
stream to a remote command 


SYNOPSIS 


remd (ahost, inport, locuser, remuser, cmd, fd2p); 
char **ahost; 

unsigned short inport; 

char *locuser, *remuser, *cmd; 

int *fd2p; 

rresvport (port); 

int *port; 

ruserok (rhost, superuser, ruser, luser); 

char *rhost; 


int superuser; 
char *ruser, *luser; 


DESCRIPTION 
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Remd is a routine used by the super-user to execute a 
command on a remote machine using an authentication 
scheme based on reserved port numbers. Rresvport is a 
routine which returns a descriptor to a socket with an 
address in the privileged port space. Ruserok is a 
routine used by servers to authenticate clients requesting 
service with remd. All three functions are present in the 
same file and are used by the rshd(1NM) server (among 
others). 


Remd looks up the host *ahost using getnamehost(3N), 
returning —1 if the host does not exist. Otherwise *ahost 
is set to the standard name of the host and a connection 
is established to a server residing at the well-known 
Internet port tnport. 


If the call succeeds, a socket of type SOCK_STREAM is 
returned to the caller and given to the remote command 
as stdin and stdout. If fd2p is non-zero, then an 
auxiliary channel to a control process will be set up, and 
a descriptor for it will be placed in *fd2p. The control 

rocess will return diagnostic output from the command 
(anit 2) on this channel and will also accept bytes on this 
channel as being CTIX signal numbers, to be forwarded 
to the process group of the command. If fd2p is 0, then 
the stderr (unit 2 of the remote Seid) will be made 
the same as the stdout and no provision is made for 
sending arbitrary signals to the remote process, although 
you may be able to get its attention by using out-of- 
band data. 


The protocol is described in rshd(1NM). 
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The rresvport routine is used to obtain a socket with a 
privileged address bound to it. This socket is suitable 
for use by remd and several other routines. Privileged 
addresses consist of a port in the range 0 to 1023. Only 
the super-user is allowed to bind an address of this sort 
to a socket. 


Ruserok takes a remote host’s name, as returned by a 
gethostent(3N) routine, two user names and a flag 
indicating if the local user’s name is the super-user. It 
then checks the files /ete/hosts.equiv and, possibly, 
-rhosts in the current working directory (normally the 
local user’s home directory) to see if the request for 
service is allowed. A 1 is returned if the machine name 
is listed in the hosts.equiv file or if the host and remote 
user name are found in the .rhosts file; otherwise 
ruserok returns 0. If the superuser flag is 1, the checking 
of the host.equiv file is bypassed. 


SEE ALSO 


BUGS 
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rlogin(iC), | remd(1C), —rexec(3N), — rexecd(1NM), 
rlogind(1NM), rshd(1NM) 


There is no way to specify options to the socket call 
which remd makes. 


NAME 


REGCMP (3X) 


regemp, regex — compile and execute regular expression 


SYNOPSIS 


char *regemp (string1 [, string2, ...], (char *)0) 
char *stringl, *string2, ...; 


char *regex (re, subject|, retO, ...]) 
char *re, *subject, *ret0O, ...; 


extern char *__locl; 


DESCRIPTION 


Regemp compiles a regular expression and returns a 
pointer to the compiled form. Malloc(3C) is used to 
create space for the vector. It is the user’s responsibility 
to free unneeded space so allocated. A NULL return 
from regemp indicates an _ incorrect argument. 
Revenant) has been written to generally preclude the 
need for this routine at execution time. 


Regex executes a compiled pattern against the subject 
string. Additional arguments are passed to receive 
values back. Regez returns NULL on failure or a pointer 
to the next unmatched character on success. A global 
character pointer __loc! points to where the match 
began. Regcemp and regex were mostly borrowed from 
the editor, ed(1); however, the syntax and semantics 
have been changed slightly. The following are the valid 
symbols and their associated meanings. 


[]*.* | These symbols retain their current meaning. 


$ Matches the end of the string; \n matches a 
new-line. 


- Within brackets the minus means through. 
For example a-z] is equivalent to 
[abed...xyz]. The — can appear as itself 
only if used as the first or last character. For 
example, the character class expression []—] 
matches the characters ] and —. 


+ A regular expression followed by + means one 
or more times. For example, [0—9]+ is 
equivalent to [O—9][O—9]*. 


{m} {m,} {m,u} . sess 
Integer values enclosed in { } indicate the 
number of times the preceding regular 
expression is to be applied. The value m is 
the minimum number and ut is a number, less 
than 256, which is the maximum. If only m is 
present (e.g., {m}), it indicates the exact 
number of times the regular expression is to be 
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applied. The value {m,} is analogous to 
{m,infinity}. The plus (+) and star (# 
operations are equivalent to {1,} and {0, 
respectively. 


(....)$n The value of the enclosed regular expression is 
to be returned. The value will be stored in the 
(n+1)th argument following the subject 
argument. At most ten enclosed regular 
expressions are allowed. Regex makes its 
assignments unconditionally. 


(...) Parentheses are used for grouping. An 
operator, e.g., *, +, { }, can work on a single 
character or a regular expression enclosed in 
parentheses. For example, (a*(cb+)*)$0. 

By necessity, all the above defined symbols are special. 

They must, therefore, be escaped to be used as 

themselves. 

EXAMPLES 
Example 1: 


char *cursor, *newcursor, *ptr; 
neweursor = regex((ptr = regcmp(”*\n”, 0)), cursor); 
free(ptr); 


This example will match a leading new-line in the 
subject string pointed at by cursor. 


Example 2: 


char ret0(9]; 
char *newcursor, *name; 


name = gta deta za—z0- ea” 0); 
newcursor = regex(name, ”123Testing321”, retO 

This example will match through the string ‘“Testing3” 
and will return the address of the character after the last 
matched character (cursor+11). The string “Testing3” 
will be copied to the character array ret0. 


, 


Example 3: 


#include "file.i” 
char *string, *newcursor; 


newcursor = regex(name, string); 


This example applies a precompiled regular expression in 
file.i (see regemp(1)) against string. 
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This routine is kept in /lib/libPW.a. 


SEE ALSO 


BUGS 


ed(1), regemp(1), malloc(3C). 


The user program may run out of memory if regemp is 
called iteratively without freeing the vectors no longer 
required. The following user-supplied replacement for 
malloc(3C) reuses the same vector saving time and 
space: 


/* user’s program */ 
char * 


malloc(n) 
unsigned n; 


static char rebuf([512]; 
return (n <= sizeof rebuf) ? rebuf : NULL; 


NAME 


REXEC(3N) 


rexec — return stream to a remote command 


SYNOPSIS 


rexec (ahost, inport, user, passwd, cmd, fd2p); 
char **ahost; 

unsigned short inport; 

char “user, *passwd, *cmd; 

int *fd2p; 


DESCRIPTION 


Rezec looks up the host *ahost using getnamehost(3N), 
returning —1 if the host does not exist. Otherwise *ahost 
is set to the standard name of the host. If a user name 
and password are both specified, then these are used to 
authenticate to the foreign host; otherwise the 
environment and then the user’s .netrc file in his home 
directory are searched for appropriate information. If all 
this fails, the user is prompted for the information. 


The port tnport specifies which well-known DARPA 
Internet port to use for the connection; it will normally 
be the value returned from the call “getnameserv("exec”, 
"tep”)” (see getservent(3N)). The protocol for 
connection is described in rerecd(1NM). 


If the call succeeds, a socket of type SOCK_STREAM is 
returned to the caller, and given to the remote command 
as stdin and stdout. If fd2p is non-zero, then a auxiliary 
channel to a control process will be set up, and a 
descriptor for it will be placed in *fd2p. The control 
process will return diagnostic output from the command 
(unit 2) on this channel and will also accept bytes on this 
channel as being CTIX signal numbers, to be forwarded 
to the process group of the command. If fd2p is 0, then 
the stderr (unit 2 of the remote command) will be made 
the same as the stdout and no provision is made for 
sending arbitrary signals to the remote process, although 


you may be able to get its attention by using out-of- 
band data. 


SEE ALSO 


BUGS 
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remd(3N), rexecd(1NM). 


There is no way to specify options to the socket call 
which rerec makes. 


SCANF (3S) 


scanf, fscanf, sscanf — convert formatted input 


SYNOPSIS 


#include <stdio.h> 
int scanf (format |, pointer]... ) 
char *format; 


int fscanf (stream, format [ , pointer]... ) 
FILE *stream; 
char *format; 


int sscanf (s, format [ , pointer]... ) 
char *s, *format; 


DESCRIPTION 


Scanf reads from the standard input stream stdin. 
Fscanf reads from the named input stream. Sscanf 
reads from the character string 8. Each function reads 
characters, interprets them according to a format, and 
stores the results in its arguments. Each expects, as 
arguments, a control string format described below, and 
a set of pointer arguments indicating where the 
converted input should be stored. 


The control string usually contains conversion 
specifications, which are used to direct interpretation of 
input sequences. The control string may contain: 


1. White-space characters (blanks, tabs, new-lines, or 
form-feeds) which, except in two cases described 
below, cause input to be read up to the next non- 
white-space character. 

2. An ordinary character (not %), which must match 
the next character of the input stream. 

3. Conversion specifications, consisting of the character 
%, an optional assignment suppressing character *, 
an optional numerical maximum field width, an 
optional 1 (ell) or h indicating the size of the 
receiving variable, and a conversion code. 


A conversion specification directs the conversion of the 
next input field; the result is placed in the variable 
pointed to by the corresponding argument, unless 
assignment suppression was indicated by *. The 
suppression of assignment provides a way of describing 
an input field which is to be skipped. An input field is 
defined as a string of non-space characters; it extends to 
the next inappropriate character or until the field width, 
if specified, is exhausted. For all descriptors except [ and 
c, white space leading an input field is ignored. 
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The conversion code indicates the interpretation of the 
input field; the corresponding pointer argument must 
usually be of a restricted type. For a suppressed field, 
no pointer argument is given. The following conversion 
codes are legal: 


% 
d 


u 


ef,g 


a single % is expected in the input at this point; 
no assignment is done. 

a decimal integer is expected; the corresponding 
argument should be an integer pointer. 

an unsigned decimal integer is expected; the 
corresponding argument should be an unsigned 
integer pointer. 

an octal integer is expected; the corresponding 
argument should be an integer pointer. 

a hexadecimal integer is expected; the 
corresponding argument should be an integer 
pointer. 

a floating point number is expected; the next 
field is converted accordingly and stored through 
the corresponding argument, which should be a 
pointer to a float. The input format for floating 
point numbers is an optionally signed string of 
digits, possibly containing a decimal point, 
followed by an optional exponent field consisting 
of an E or an e, followed by an optional +, -, 
or space, followed by an integer. 

a character string is expected; the corresponding 
argument should be a character pointer pointing 
to an array of characters large enough to accept 
the string and a terminating \0, which will be 
added automatically. The input field is 
terminated by a white-space character. 

a character is expected; the corresponding 
argument should be a character pointer. The 
normal skip over white space is suppressed in 
this case; to read the next non-space character, 
use %1s. If a field width is given, the 
corresponding argument should refer to a 
character array; the indicated number of 
characters is read. 

indicates string data and the normal skip over 
leading white space is suppressed. The left 
bracket is followed by a set of characters, which 
we will call the scanset, and a right bracket; the 
input field is the maximal sequence of input 
characters consisting entirely of characters in the 
scanset. The circumflex ( *), when it appears as 
the first character in the scanset, serves as a 
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complement operator and redefines the scanset 
as the set of all characters not contained in the 
remainder of the scanset string. There are some 
conventions used in the construction of the 
scanset. A range of characters may be 
represented by the construct first-last, thus 
[0123456789] may be expressed [0-9]. Using this 
convention, first must be lexically less than or 
equal to last, or else the dash will stand for 
itself. The dash will also stand for itself 
whenever it is the first or the last character in 
the scanset. To include the right square bracket 
as an element of the scanset, it must appear as 
the first character (possibly preceded by a 
circumflex) of the scanset, and in this case it will 
not be syntactically interpreted as the closing 
bracket. The corresponding argument must 
point to a character array large enough to hold 
the data field and the terminating \0, which will 
be added automatically. At least one character 
must match for this conversion to be considered 
successful. 


The conversion characters d, u, 0, and x may be 
preceded by 1 or h to indicate that a pointer to long or 
to short rather than to int is in the argument list. 
Similarly, the conversion characters e, f, and g may be 
preceded by I to indicate that a pointer to double rather 
than to float is in the argument list. The 1 or h 
modifier is ignored for other conversion characters. 


Scanf conversion terminates at EOF, at the end of the 
control string, or when an input character conflicts with 
the control string. In the latter case, the offending 
character is left unread in the input stream. 


Scanf returns the number of successfully matched and 
assigned input items; this number can be zero in the 
event of an early conflict between an input character and 
the control string. If the input ends before the first 
conflict or conversion, EOF is returned. 
EXAMPLES 

The call: 

int i, n; float x; char name[50]; 

n = scanf ("%d%f%s", &i, &x, name); 


with the input line: 
25 54.32E-1 thompson 


will assign to n the value 3, to ¢ the value 25, to z the 
value 5.432, and name will contain thompson\0. Or: 
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int i; float x; char name(50]; 
(void) scanf ("%2d%f%*d %[0-9]", &i, &x, 
name); 
with input: 
56789 0123 56a72 
will assign 56 to t, 789.0 to z, skip 0123, and place the 
string 56\0 in name. The next call to getchar (see 
getc(3S)) will return a. 
SEE ALSO 
getc(3S), printf(3S), strtod(3C), strtol(3C). 
NOTE 
Trailing white space (including a new-line) is left unread 
unless matched in the control string. 


DIAGNOSTICS 
These functions return EOF on end of input and a short 
count for missing or illegal data items. 


BUGS 


The success of literal matches and _ suppressed 
assignments is not directly determinable. 
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NAME 
setbuf, setvbuf — assign buffering to a stream 


SYNOPSIS 
#tinclude <stdio.h> 


void setbuf (stream, buf) 
FILE *stream; 
char *buf; 


int setvbuf (stream, buf, type, size) 
FILE *stream; 
char *buf; 
int type, size; 

DESCRIPTION 
Setbuf may be used after a stream has been opened but 
before it is read or written. It causes the array pointed 
to by buf to be used instead of an automatically 
allocated buffer. If buf is the NULL pointer input/output 
will be completely unbuffered. 


A constant BUFSIZ, defined in the <stdio.h> header 
file, tells how big an array is needed: 


char buf[BUFSIZ]; 


Setvbuf may be used after a stream has been opened but 
before it is read or written. Type determines how 
stream will be buffered. Legal values for type (defined 
in stdio.h) are: 


_IOFBF causes input/output to be fully buffered. 
_IOLBF causes output to be line buffered; the 
buffer will be flushed when a newline is 
written, the buffer is full, or input is 
requested. 
_IONBF causes input/output to be completely 
unbuffered. 
If buf is not the NULL pointer, the array it points to will 
be used for buffering, instead of an automatically 
allocated buffer. Stze specifies the size of the buffer to 
be used. The constant BUFSIZ in <stdio.h> is 
suggested as a good buffer size. If input/output is 
unbuffered, buf and size are ignored. 
By default, output to a terminal is line buffered and all 
other input/output is fully buffered. 
SEE ALSO 
fopen(3S), getc(3S), malloc(3C), putc(3S), stdio(3S). 
DIAGNOSTICS 
If an illegal value for type or stze is provided, setvbuf 
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returns a non-zero value. Otherwise, the value returned 
will be zero. 

NOTE 
A common source of error is allocating buffer space as an 
“automatic” variable in a code block, and then failing to 
close the stream in the same block. 


SETJMP(3C) 


NAME 

setjmp, longjmp — non-local goto 
SYNOPSIS 

#include <setjmp.h> 


int setjmp (env) 
jmp_buf env; 


void longjmp (env, val) 
jmp_buf env; 
int val; 


DESCRIPTION 
These functions are useful for dealing with errors and 
interrupts encountered in a low-level subroutine of a 
program. 


Setjmp saves its stack environment in env (whose type, 
jmp_buf, is defined in the <setjmp.h> header file) for 
later use by longjmp. It returns the value 0. 


Longjmp restores the environment saved by the last call 
of setjmp with the corresponding env argument. After 
longjmp is completed, program execution continues as if 
the corresponding call of setymp (which must not itself 
have returned in the interim) had just returned the value 
val. Longjmp cannot cause setymp to return the value 
0. If longjmp is invoked with a second argument of 0, 
setjmp will return 1. All accessible data had values as of 
the time longjmp was called. 

SEE ALSO 
signal(2). 

WARNING 
If longjmp is called even though env was never primed 
by a call to setjymp, or when the last such call was in a 
function which has since returned, absolute chaos is 
guaranteed. 
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NAME 

sinh, cosh, tanh — hyperbolic functions 
SYNOPSIS 

#include <math.h> 

double sinh (x) 

double x; 


double cosh (x) 
double x; 


double tanh (x) 
double x; 
DESCRIPTION 
Sinh, cosh, and tanh return, respectively, the hyberbolic 
sine, cosine and tangent of their argument. 
DIAGNOSTICS 
Sinh and cosh return HUGE (and sinh may return 
~HUGE for negative z) when the correct value would 
overflow and set errno to ERANGE. 
These error-handling procedures may be changed with 
the function matherr(3M). 
SEE ALSO 
matherr(3M). 
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NAME 
sleep — suspend execution for interval 


SYNOPSIS 
unsigned sleep (seconds) 
unsigned seconds; 


DESCRIPTION 

The current process is suspended from execution for the 
number of seconds specified by the argument. The 
actual suspension time may be less than that requested 
for two reasons: (1) Because scheduled wakeups occur at 
fixed 1-second intervals, (on the second, according to an 
internal clock) and () because any caught signal will 
terminate the sleep following execution of that signal’s 
catching routine. Also, the suspension time may be 
longer than requested by an arbitrary amount due to the 
scheduling of other activity in the system. The value 
returned by sleep will be the ‘‘unslept”? amount (the 
requested time minus the time actually slept) in case the 
caller had an alarm set to go off earlier than the end of 
the requested sleep time, or premature arousal due to 
another caught signal. 


The routine is implemented by setting an alarm signal 
and pausing until it (or some other signal) occurs. The 
revious state of the alarm signal is saved and restored. 
he calling program may have set up an alarm signal 
before calling sleep. If the sleep time exceeds the time 
till such alarm signal, the process sleeps only until the 
alarm signal would have occurred. The caller’s alarm 
catch routine is executed just before the sleep routine 
returns. But if the sleep time is less than the time till 
such alarm, the prior alarm time is reset to go off at the 
same time it would have without the intervening sleep. 


SEE ALSO 
alarm(2), pause(2), signal(2). 
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NAME 
sputl, sgetl — access Jong integer data in a machine- 
independent fashion. 


SYNOPSIS 
void sputl (value, buffer) 
long value; 
char *buffer; 


long sgetl (buffer) 
char *buffer; 


DESCRIPTION 
Sputl takes the four bytes of the long integer value and 
places them in memory starting at the address pointed to 
by buffer. The ordering of the bytes is the same across 
all machines. 


Sgetl retrieves the four bytes in memory starting at the 
address pointed to by buffer and returns the long integer 
value in the byte ordering of the host machine. 


The combination of sputl and sgetl provides a machine- 
independent way of storing long numeric data in a file in 
binary form without conversion to characters. 


A program which uses these functions must be loaded 
with the object-file access routine library libld.a. 
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NAME 
ssignal, gsignal — software signals 


SYNOPSIS 
#include <signal.h> 
int (*ssignal (sig, action))( ) 
int sig, tection ); 
int gsignal (sig) 
int sig; 

DESCRIPTION 
Ssignal and gstgnal implement a software facility similar 
to signal(2). This facility is used by the Standard C 
Library to enable users to indicate the disposition of 
error conditions, and is also made available to users for 
their own purposes. 


Software signals made available to users are associated 
with integers in the inclusive range 1 through 15. A call 
to ssignal associates a procedure, actton, with the 
software signal stg; the software signal, stg, is raised by 
a call to gsignal. Raising a software signal causes the 
action established for that signal to be taken. 


The first argument to ssignal is a number identifying the 
type of signal for which an action is to be established. 
The second argument defines the action; it is either the 
name of a (user-defined) action function or one of the 
manifest constants SIG_DFL (default) or SIG_IGN 
(ignore). Ssignal returns the action previously 
established for that signal type; if no action has been 
established or the signal number is illegal, sstgnal returns 
SIG_DFL. 


Gsignal raises the signal identified by its argument, 87g: 


If an action function has been established for szg, 
then that action is reset to SIG_DFL and the 
action function is entered with argument szg. 
Gstgnal returns the value returned to it by the 
action function. 


If the action for stg is SIG_LIGN, gstgnal returns 
the value 1 and takes no other action. 


If the action for stg is SIG_LDFL, gstgnal returns 
the value 0 and takes no other action. 


If stg has an illegal value or no action was ever 
specified for stg, gsignal returns the value 0 and 
takes no other action. 
SEE ALSO 
signal(2). 


NOTES 
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There are some additional signals with numbers outside 
the range 1 through 15 which are used by the Standard 
C Library to indicate error conditions. Thus, some 
signal numbers outside the range 1 through 15 are legal, 
although their use may interfere with the operation of 
the Standard C Library. 
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NAME 
stdio — standard buffered input/output package 


SYNOPSIS 
#include <stdio.h> 


FILE *stdin, *stdout, *stderr; 


DESCRIPTION 

The functions described in the entries of sub-class 35 of 
this manual constitute an efficient, user-level I/O 
buffering scheme. The in-line macros getc(3S) and 
putc(3S) handle characters quickly. The macros getchar 
and putchar, and the higher-level routines fgetc, fgets, 
fprintf, fpute, fputs, fread, fecanf, fwrite, gets, getw, 
printf, puts, putw, and scanf all use or act as if they use 
getc and putc; they can be freely intermixed. 


A file with associated buffering is called a stream and is 
declared to be a pointer to a defined type FILE. 
Fopen(3S) creates certain descriptive data for a stream 
and returns a pointer to designate the stream in all 
further transactions. Normally, there are three open 
streams with constant pointers declared in the 
<stdio.h> header file and associated with the standard 
open files: 


stdin standard input file 
stdout = standard output file 
stderr standard error file 


A constant NULL (0) designates a nonexistent pointer. 


An integer-constant EOF (-1) is returned upon end-of- 
file or error by most integer functions that deal with 
streams (see the individual descriptions for details). 


An integer constant BUFSIZ specifies the size of the 
buffers used by the particular implementation. 


Any program that uses this package must include the 
header file of pertinent macro definitions, as follows: 


#include <stdio.h> 


The functions and constants mentioned in the entries of 
sub-class 3S of this manual are declared in that header 
file and need no further declaration. The constants and 
the following “functions” are implemented as macros 
(redeclaration of these names is perilous): getc, getchar, 
putc, putchar, ferror, feof, clearerr, and fileno. 
SEE ALSO 

open(2), close(2), Iseek(2), pipe(2), eae write(2), 
ctermid(3S), cuserid(3S), felose(38), ferror(3S), fopen 48 
fread(3S), fseek(3S),  gete(3S), ey popen 3S), 
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printf(3S), putc(3S), puts(3S), scanf(3S), setbuf(3S), 
system(3S), tmpfile(3S), tmpnam(3S), ungetc(3S). 


DIAGNOSTICS 
Invalid stream pointers will usually cause grave disorder, 


possibly including program termination. Individual 
function descriptions describe the possible error 
conditions. 

— 

a 
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NAME 
ftok — standard interprocess communication package 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipe.h> 


key_t ftok(path, id) 
char *path; 
char id; 


DESCRIPTION 

All interprocess communication facilities require the user 
to supply a key to be used by the msgget(2), semget(2), 
and shmget(2) system calls to obtain interprocess 
communication identifiers. One suggested method for 
forming a key is to use the ftok subroutine described 
below. Another way to compose keys is to include the 
project ID in the most significant byte and to use the 
remaining portion as a sequence number. There are 
many other ways to form keys, but it is necessary for 
each system to define standards for forming them. If 
some standard is not adhered to, it will be possible for 
unrelated processes to unintentionally interfere with each 
other’s operation. Therefore, it is strongly suggested 
that the most significant byte of a key in some sense 
refer to a project so that keys do not conflict across a 
given system. 


Ftok returns a key based on path and td that is usable in 
subsequent msgget, semget, and shmget system calls. 
Path must be the path name of an existing file that is 
accessible to the process. Jd is a character which 
uniquely identifies a project. Note that ftok will return 
the same key for linked files when called with the same 
td and that it will return different keys when called with 
the same file name but different tds. 


SEE ALSO 
intro(2), msgget(2), semget(2), shmget(2). 

DIAGNOSTICS 
Ftok returns (key_t) —1 if path does not exist or if it is 
not accessible to the process. 


WARNING 
If the file whose path is passed to ftok is removed when 
keys still refer to the file, future calls to ftok with the 
same path and td will return an error. If the same file is 
recreated, then ftok is likely to return a different key 
than it did the original time it was called. 
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NAME 
strcat, strncat, strcmp, strnemp, strepy, strncpy, strlen, 
strchr, strrchr, strpbrk, strspn, strespn, strtok — string 
operations 


SYNOPSIS 
#include <string.h> 


char *strcat (sl, 82) 
char *sl, *s2; 


char *strncat (sl, s2, n) 
char *sl, *s2; 
int n; 


int stremp (sl, s2) 
char *sl, *s2; 


int strnemp (sl, s2, n) 
char *sl, *s2; 
int n; 


char *strcepy (sl, s2) 
char *sl, *s2; 


char *strncpy (sl, s2, n) 
char *sl1, *s82; 
int n; 


int strlen (s) 
char *s; 


char *strchr (s, c) 
char *s; 
int c; 
char *strrchr (s, c) 
char *s; 
int ¢; 
char *strpbrk (s1, 82) 
char *s1, *82; 
int strspn (sl, s2) 
char *s1, *s2; 
int strespn (s1, 82) 
char *sl, *s2; 
char *strtok (sl, s2) 
char *s1, *82; 
DESCRIPTION 
The arguments s1, s2 and s point to strings (arrays of 
characters terminated by a null character). The 
functions sércat, strncat, strepy and sirncpy all alter sl. 


These functions do not check for overflow of the array 
pointed to by sl. 


NOTE 


STRING (3C) 


Streat appends a copy of string s2 to the end of string 
si. Strneat appends at most n characters. Each returns 
a pointer to the null-terminated result. 


Stremp compares its arguments and returns an integer 
less than, equal to, or greater than 0, according as s1 is 
lexicographically less than, equal to, or greater than 82. 
Strnemp makes the same comparison but looks at at 
most n characters. 


Strepy copies string s2 to si, stopping after the null 
character has been copied. Strnepy copies exactly n 
characters, truncating s2 or adding null characters to s1 
if necessary. The result will not be null-terminated if 
the length of s2 is n or more. Each function returns s1. 


Strlen returns the number of characters in 8, not 
including the terminating null character. 


Strchr (strrehr) returns a pointer to the first (last) 
occurrence of character ¢ in string s, or a NULL pointer 
if ¢ does not occur in the string. The null character 
terminating a string is considered to be part of the 
string. 


Strpbrk returns a pointer to the first occurrence in string 
81 of any character from string 82, or a NULL pointer if 
no character from 82 exists in 61. 


Strspn (strespn) returns the length of the initial segment 
of string sf which consists entirely of characters from 
(not from) string 62. 


Strtok considers the string 81 to consist of a sequence of 
zero or more text tokens separated by spans of one or 
more characters from the separator string 82. The first 
call (with pointer s1 specified) returns a pointer to the 
first character of the first token, and will have written a 
null character into sf immediately following the 
returned token. The function keeps track of its position 
in the string between separate calls, so that subsequent 
calls (which must be made with the first argument a 
NULL pointer) will work through the string s1 
immediately following that token. In this way 
subsequent calls will work through the string s1 until no 
tokens remain. The separator string s2 may be different 
from call to call. When no token remains in si, a NULL 
pointer is returned. 


For user convenience, all these functions are declared in 
the optional <string.h> header file. 


BUGS 
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Stremp and strnemp use native character comparison, 
which is signed on Convergent Technologies 68000- 
family processors. This means that characters are 8-bit 
signed values; all ASCII characters have values of at 
least 0; non-ASCII are negative. On some machines, all 
characters are positive. Thus programs that only 
compare ASCII values are portable; programs that 
compare ASCII with non-ASCII values are not. 


Character movement is performed differently in different 
implementations. Thus, overlapping moves may yield 
surprises. 


NAME 
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strtod, atof — convert string to double-precision number 


SYNOPSIS 


double strtod (str, ptr) 
char *str, **ptr; 


double atof (str) 
char *str; 


DESCRIPTION 


Strtod returns as a  double-precision floating-point 
number the value represented by the character string 
pointed to by str. The string is scanned up to the first 
unrecognized character. 


Strtod recognizes an optional string of “white-space” 
characters (as defined by tsspace in ctype(3C)), then an 
optional sign, then a string of digits optionally 
containing a decimal point, then an optional e or E 
followed by an optional sign or space, followed by an 
integer. 


If the value of pér is not (char **)NULL, a pointer to the 
character terminating the scan is returned in the location 
pointed to by ptr. If no number can be formed, *ptr is 
set to str, and zero is returned. 


Atof(str) is equivalent to strtod(str, (char **)NULL). 


SEE ALSO 


ctype(3C), scanf(3S), strtol(3C). 


DIAGNOSTICS 


If the correct value would cause overflow, +HUGE is 
returned (according to the sign of the value), and errno 
is set to ERANGE. 

If the correct value would cause underflow, zero is 
returned and errno is set to ERANGE. 
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NAME 
strtol, atol, atoi — convert string to integer 

SYNOPSIS 
long strtol (str, ptr, base) 
char *str, **ptr; 
int base; 
long atol (str) 
char *str; 
int atoi (str) 
char ‘str; 

DESCRIP TION 
Strtol returns as a long integer the value represented by 
the character string pointed to by str. The string is 
scanned up to the first character inconsistent with the 
base. Leading ‘‘white-space” characters (as defined by 
isspace in ctype(3C)) are ignored. 
If the value of pér is not (char **)NULL, a pointer to the 
character terminating the scan is returned in the location 
pointed to by pir. If no integer can be formed, that 
location is set to str, and zero is returned. 
If base is positive (and not greater than a0): it is used as 
the base for conversion. After an optional leading sign, 
leading zeros are ignored, and ‘‘Ox” or ‘‘OX” is ignored if 
base is 16. 
If base is zero, the string itself determines the base 
thusly: After an optional leading sign a leading zero 
indicates octal conversion, and a leading ‘Ox’ or “OX” 
hexadecimal conversion. Otherwise, decimal conversion 
is used. 
Truncation from long to int can, of course, take place 
upon assignment or by an explicit cast. 
Atol(str) is equivalent to strtol(str, (char **)NULL, 10). 
Atoi(str) is equivalent to (tnt) strtol(str, (char **)NULL, 
10). 

SEE ALSO 
ctype(3C), scanf(3S), strtod(3C). 

BUGS 


Overflow conditions are ignored. 
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NAME 
swab — swap bytes 


SYNOPSIS 
void swab (from, to, nbytes) 
char *from, *to; 
int nbytes; 


DESCRIPTION 
Swab copies nbytes bytes pointed to by from to the 
array pointed to by to, exchanging adjacent even and 
odd bytes. It is useful for carrying binary data between 
PDP-11is and other machines. Nbytes should be even and 
non-negative. If nbytes is odd and positive swab uses 
nbytes—1 instead. If nbytes is negative, swab does 
nothing. 
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NAME 
system — issue a shell command 


SYNOPSIS 
#include <stdio.h> 


int system (string) 
char ‘string; 


DESCRIPTION 
System causes the string to be given to sh(1) as input, 
as if the string had been typed as a command at a 
terminal. The current process waits until the shell has 
completed, then returns the exit status of the shell. 


FILES 
/bin/sh 
SEE ALSO 
sh(1), exec(2). 
DIAGNOSTICS 
System forks to create a child process that in turn exec’s 


/bin/sh in order to execute string. If the fork or exec 
fails, system returns a negative value and sets errno. 


NAME 
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tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs — 
terminal independent operations 


SYNOPSIS 


char PC; 
char *BC; 
char *UP; 
short ospeed; 


tgetent(bp, name) 
char *bp, *name; 
tgetnum(id) 

char *id; 
tgetflag(id) 

char *id; 

char * 

tgetstr(id, area) 
char *id, **area; 


char * 
tgoto(cmstr, destcol, destline) 
char *cmstr; 


tputs(cp, affent, outc) 
register char *cp; 

int affcnt; 

int (*outc)(); 


DESCRIPTION 


These functions extract and use information from 
terminal descriptions that follow the conventions in 
termeap(4). The functions only do basic screen 
manipulation: they find and output specified terminal 
function strings and interpret the cm string. Curses(3X) 
describes a screen updating package built on termcap. 


Tgetent finds and copies a terminal description. Name is 
the name of the description; bp points to a buffer to hold 
the description. Tgetent passes bp to the other termcap 
functions; the buffer must remain allocated until the 
program is done with the termcap functions. 


Tgetent uses the TERM and TERMCAP environment 


variables to locate the terminal description. 


e If TERMCAP isn’t set or is empty, tgetent 
searches for name in /ete/termcap. 
° If TERMCAP contains the full pathname of a 


file eae string that begins with /), tgetent 
searches for name in that file. 
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° If TERMCAP contains any string that does 
not begin with / and TERM is not set or 
matches name, tgetent copies the TERMCAP 


string. 

° If TERMCAP contains any string that does 
not begin with / and TERM does not match 
name,  tgetent searches for name _ in 
/ete/termeap. 


Tgetent returns -1 if it couldn’t open the terminal 
capability file, O if it couldn’t find an entry for name, 
and 1 upon success. 


Tgetnum returns the value of the numeric capability 
whose name is td. It returns —1 if the terminal lacks the 
specified capability or it is not a numeric capability. 


Tgetflag returns 1 if the terminal has boolean capability 
whose name is td, 0 if it does not or it is not a boolean 
capability. 


Tgetstr copies and interprets the value of the string 
capability named by td. Tgetstr expands instances in 
the string of \ and *. It leaves the expanded string in 
the buffer tndirectly pointed to by area and leaves the 
buffer’s direct pointer pointing to the end of the 
expanded string; for example, 


tgetstr("cl”, &ptr); 


where ptr is a character pointer -- not an array name! 
Tgetstr returns a (direct) pointer to the beginning of the 
string. 


Tgoto interprets the % escapes in a em string. It 
returns cmstr with the % sequences changed to the 
position indicated by destcol and destline. This function 
must have the external variables BC and UP set to the 
values of the be and up capabilities; if the terminal 
lacks the capability, set the external variable to null. If 
tgoto can’t interpret all the % sequences in em, it 
returns “OOPS” 


Tgoto avoids producing characters that might be 
misinterpreted by the terminal interface. If expanding a 
% sequence would produce a null, control-d, or null, the 
function will, if possible, send the cursor to the next line 
or column and use BC or UP to move to the correct 
location. Note that tgoto does not avoid producing tabs; 
a program must turn off the TAB3 feature of the 
terminal interface ({termto(7)). This is a good idea 
anyway: some terminals use the tab character as a 
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nondestructive space. 


Tputs directs the output of a string returned by égetstr 
or tgoto. This function must have the external variable 
PC set to the value of the pe capability; if the terminal 
lacks the capability, set the external variable to null. 
Tputs interprets any delay at the beginning of the string. 
Cp is the string to be output; affent is the number of 
lines affected by the action (1 if “number of lines 
affected” doesn’t mean anything); and oute points to a 
function that takes a single char argument and outputs 
it, such as putchar. 


FILES 
/usr/lib/libtermcap.a library 
/etc/termcap data base 
SEE ALSO 


ex(1), curses(3), termcap(5) 


NAME 
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tmpfile — create a temporary file 


SYNOPSIS 


#include <stdio.h> 
FILE *tmpfile () 


DESCRIPTION 


Tmpfile creates a temporary file using a name generated 
by enpnene>): and returns a corresponding FILE 
pointer. If the file cannot be opened, an error message is 
printed using perror(3C), and a NULL pointer is 
returned. The file will automatically be deleted when 
the process using it terminates. The file is opened for 
update ("w+"). 


SEE ALSO 


creat(2), unlink(2), fopen(3S), mktemp(3C), perror(3C), 
tmpnam(3S). 
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NAME 
tmpnam, tempnam - create a name for a temporary file 


SYNOPSIS 
#include <stdio.h> 


char *tmpnam (s) 
char *s; 


char *tempnam (dir, pfx) 
char *dir, *pfx; 


DESCRIPTION 
These functions generate file names that can safely be 
used for a temporary file. 


Tmpnam always generates a file name using the path- 
prefix defined as P_tmpdir in the <stdto.h> header 
file. If s is NULL, tmpnam leaves its result in an internal 
static area and returns a pointer to that area. The next 
call to tmpnam will destroy the contents of the area. If 
s is not NULL, it is assumed to be the address of an 
array of at least L_tmpnam bytes, where L_tmpnam 
is a constant defined in <stdio.h>; tmpnam places its 
result in that array and returns s. 


Tempnam allows the user to control the choice of a 
directory. The argument dir points to the name of the 
directory in which the file is to be created. If dir is 
NULL or points to a string which is not a name for an 
appropriate directory, the path-prefix defined as 
P_tmpdir in the <stdio.h> header file is used. If that 
directory is not accessible, /tmp will be used as a last 
resort. This entire sequence can be up-staged by 
providing an environment variable TMPDIR in the 
user’s environment, whose value is the name of the 
desired temporary-file directory. 


Many applications prefer their temporary files to have 
certain favorite initial letter sequences in their names. 
Use the pfx argument for this. This argument may be 
NULL or point to a string of up to five characters to be 
used as the first few characters of the temporary-file 
name. 


Tempnam uses malloc(3C) to get space for the 
constructed file name, and returns a pointer to this area. 
Thus, any pointer value returned from tempnam may 
serve as an argument to free (see malloc(3C)). If 
tempnam cannot return the expected result for any 
reason, i.e. eee) failed, or none of the above 
mentioned attempts to find an appropriate directory was 
successful, a NULL pointer will be returned. 


NOTES 
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These functions generate a different file name each time 
they are called. 


Files created using these functions and either fopen(3S) 
or creat(2) are temporary only in the sense that they 
reside in a directory intended for temporary use, and 
their names are unique. It is the user’s responsibility to 
use unlink (2) to remove the file when its use is ended. 


SEE ALSO 


BUGS 


creat?) unlink(2), fopen(3S), malloc(3C), mktemp(3C), 
tmpfile(3S). 


If called more than 17,576 times in a single process, these 
functions will start recycling previously used names. 
Between the time a file name is created and the file is 
opened, it is possible for some other process to create a 
file with the same name. This can never happen if that 
other process is using these functions or mktemp, and the 
file names are chosen so as to render duplication by 
other means unlikely. 
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NAME 
sin, cos, tan, asin, acos, atan, atan2 — trigonometric 
functions 
SYNOPSIS 
#include <math.h> 
double sin (x) 
double x; 
double cos (x) 
double x; 
double tan (x) 
double x; 
double asin (x) 
double x; 
double acos (x) 
double x; 
double atan (x) 
double x; 
double atan2 (y, x) 
double y, x; 
DESCRIPTION 
Sin, cos and tan return respectively the sine, cosine and 
tangent of their argument, z, measured in radians. 
Asin returns the arcsine of z, in the range —7/2 to 7/2. 
Acos returns the arccosine of z, in the range 0 to 7. 
Atan returns the arctangent of z, in the range —7/2 to 
n/2. 
Atan@ returns the arctangent of y/z, in the range —7 to 
m, using the signs of both arguments to determine the 
quadrant of the return value. 
DIAGNOSTICS 


Stn, cos, and tan lose accuracy when their argument is 
far from zero. For arguments sufficiently large, these 
functions return zero when there would otherwise be a 
complete loss of significance. In this case a message 
indicating TLOSS error is printed on the standard error 
output. For less extreme arguments causing partial loss 
of significance, a PLOSS error is generated but no 
message is printed. In both cases, errno is set to 
ERANGE. 


If the magnitude of the argument of asin or acos is 
greater than one, or if both arguments of atan2 are zero, 
zero is returned and errno is set to EDOM. In addition, 
a message indicating DOMAIN error is printed on the 
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standard error output. 


These error-handling procedures may be changed with 
the function matherr(3M). 


SEE ALSO 
matherr(3M). 
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NAME 
tsearch, tfind, tdelete, twalk — manage binary search 
trees 


SYNOPSIS 
#include <search.h> 


char *tsearch ((char *) key, (char **) rootp, 
compar) 
int (*compar)( ); 


char *tfind ((char *) key, (char **) rootp, 
compar) 
int (*compar)( ); 


char *tdelete ((char *) key, (char **) rootp, 
compar) 
int (*compar)( ); 


void twalk ((char *) root, action) 
void (*action)( ); 

DESCRIPTION 
Tsearch, tfind, tdelete, and twalk are routines for 
manipulating binary search trees. They are generalized 
from Knuth (6.2.2) Algorithms T and D. All 
comparisons are done with a user-supplied routine. This 
routine is called with two arguments, the pointers to the 
elements being compared. It returns an integer less 
than, equal to, or greater than 0, according to whether 
the first argument is to be considered less than, equal to 
or greater than the second argument. The comparison 
function need not compare every byte, so arbitrary data 
may be contained in the elements in addition to the 
values being compared. 


Tsearch is used to build and access the tree. Key is a 
pointer to a datum to be accessed or stored. If there is a 
datum in the tree equal to «key (the value pointed to by 
key), a pointer to this found datum is returned. 
Otherwise, *key is inserted, and a pointer to it returned. 
Only pointers are copied, so the calling routine must 
store the data. Rootp points to a variable that points 
to the root of the tree. A NULL value for the variable 
pointed to by rootp denotes an empty tree; in this case, 
the variable will be set to point to the datum which will 
be at the root of the new tree. 


Like tsearch, tfind will search for a datum in the tree, 
returning a pointer to it if found. However, if it is not 
found, tfind will return a NULL pointer. The arguments 
for tfind are the same as for tsearch. 
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Tdelete deletes a node from a binary search tree. The 
arguments are the same as for tsearch. The variable 
pointed to by rootp will be changed if the deleted node 
was the root of the tree. Tdelete returns a pointer to the 
parent of the deleted node, or a NULL pointer if the node 
is not found. 


Twalk traverses a binary search tree. Root is the root 
of the tree to be traversed. (Any node in a tree may be 
used as the root for a walk below that node.) Action is 
the name of a routine to be invoked at each node. This 
routine is, in turn, called with three arguments. The 
first argument is the address of the node being visited. 
The second argument is a value from an enumeration 
data type typedef enum { preorder, postorder, endorder, 
leaf } VISIT; (defined in the <search.h > header file), 
depending on whether this is the first, second or third 
time that the node has been visited (during a depth-first, 
left-to-right traversal of the tree), or whether the node is 
a leaf. The third argument is the level of the node in 
the tree, with the root being level zero. 


The pointers to the key and the root of the tree should 
be of type pointer-to-element, and cast to type pointer- 
to-character. Similarly, although declared as type 
pointer-to-character, the value returned should be cast 
into type pointer-to-element. 


EXAMPLE 
The following code reads in strings and stores structures 
containing a pointer to each string and a count of its 
length. It then walks the tree, printing out the stored 
strings and their lengths in alphabetical order. 


#include <search.h> 
#include <stdio.h> 


struct node { 
/* pointers to these are stored in the tree */ 
char #string; 


int length; 
} 
char string_space(10000]; /* space to store strings */ 
struct node nodes[500]; /* nodes to store */ 


struct node *root = NULL; 
/* this points to the root */ 


main{ ) 

{ 
char *strptr = string_space; 
struct node *nodeptr = nodes; 
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void print_node( ), twalk( ); 
int i = 0, node_compare( ); 


while (gets(strptr) != NULL && i++ < 500) { 
/* set node */ 
nodeptr— >string = strptr; 
nodeptr- >length = strlen(strptr); 
/* put node into the tree */ 
(void) tsearch((char *)nodeptr, &root, 
node_compare); 

/* adjust pointers, 

so we don’t overwrite tree */ 
strptr += nodeptr—->length + 1; 
nodeptr++; 


} 


twalk(root, print_node); 


This routine compares two nodes, based on an 
alphabetical ordering of the string field. 

*/ 

int 

node_compare(nodel, node2) 

struct node *nodel, *node2; 


return stremp(nodel->string, node2- >string); 


/* 
This routine prints out a node, the first time 
twalk encounters it. 

*/ 

void 


print_node(node, order, level) 
struct node **node; 
VISIT order; 
int level; 
{ 
if (order == preorder || order == leaf) 
(void)printf("string = %20s, length = %d\n”, 
(*node)- >string, (*node)—>length); 


} 
SEE ALSO 
bsearch(3C), hsearch(3C), lsearch(3C). 


DIAGNOSTICS 
A NULL pointer is returned by tsearch if there is not 
enough space available to create a new node. 
A NULL pointer is returned by tsearch, tfind and tdelete 
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if rootp is NULL on entry. 

If the datum is found, both tsearch and ¢tfind return a 
pointer to it. If not, tf/ind returns NULL, and tsearch 
returns a pointer to the inserted item. 


WARNINGS 


BUGS 


The root argument to twalk is one level of indirection 
less than the rootp arguments to tsearch and tdelete. 
There are two nomenclatures used to refer to the order 
in which tree nodes are visited. Tsearch uses preorder, 
postorder and endorder to respectively refer to visting a 
node before any of its children, after its left child and 
before its right, and after both its children. The 
alternate nomenclature uses preorder, inorder and 
postorder to refer to the same visits, which could result 
in some confusion over the meaning of postorder. 


If the calling function alters the pointer to the root, 
results are unpredictable. 


NAME 


TTYNAME(3C) 


ttyname, isatty — find name of a terminal 


SYNOPSIS 


char *ttyname (fildes) 
int fildes; 


int isatty (fildes) 
int fildes; 


DESCRIPTION 


FILES 


Ttyname returns a pointer to a string containing the 
null-terminated path name of the terminal device 
associated with file descriptor fildes. 


Isatty returns 1 if fildes is associated with a terminal 
device, 0 otherwise. 


/dev/* 


DIAGNOSTICS 


BUGS 


Ttyname returns a NULL pointer if fildes does not 
describe a terminal device in directory /dev. 


The return value points to static data whose content is 
overwritten by each call. 


TTYSLOT(3C) 


NAME 
ttyslot — find the slot in the utmp file of the current 
user 

SYNOPSIS 
int ttyslot ( ) 

DESCRIPTION 


Ttyslot returns the index of the current user’s entry in 
the /ete/utmp file. This is accomplished by actually 
scanning the file /etc/inittab for the name of the 
terminal associated with the standard input, the 
standard output, or the error output (0, 1 or 2). 


FILES 
/etc/inittab 
/etc/utmp 
SEE ALSO 
getut(3C), ttyname(3C). 


DIAGNOSTICS 
A value of 0 is returned if an error was encountered 
while searching for the terminal name or if none of the 
above file descriptors is associated with a terminal 
device. 


UNGETC(3S) 


NAME 
ungete — push character back into input stream 


SYNOPSIS 
#include <stdio.h> 


int ungetc (c, stream) 
int c¢; 
FILE *stream; 


DESCRIPTION 
Ungete inserts the character ¢ into the buffer associated 
with an input stream. That character, c, will be 
returned by the next gete({8S) call on that stream. 
Ungete returns c, and leaves the file stream unchanged. 


One character of pushback is guaranteed, provided 
something has already been read from the stream and 
the stream is actually buffered. In the case that stream 
is stdin, one character may be pushed back onto the 
buffer without a previous read statement. 


If c equals EOF, ungete does nothing to the buffer and 
returns EOF. 


Fseek(3S) erases all memory of inserted characters. 


SEE ALSO 
fseek(3S), getc(3S), setbuf(3S). 


DIAGNOSTICS 
Ungete returns EOF if it cannot insert the character. 


— 
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NAME 
vprintf, vfprintf, vsprintf — print formatted output of a 
varargs argument list 


SYNOPSIS 
#include <stdio.h> 
#tinclude <varargs.h> 


int vprintf (format, ap) 
char *format; 
va_list ap; 


int vfprintf (stream, format, ap) 
FILE *stream; 

char *format; 

va_list ap; 


int vsprintf (s, format, ap) 
char *s, *format; 
va_list ap; 

DESCRIPTION 
uprintf, ufprintf, and vsprintf are the same as printf, 
fprintf, and sprintf respectively, except that instead of 
being called with a variable number of arguments, they 
are called with an argument list as defined by 
varargs(5). 

EXAMPLE 
The following demonstrates how vfprintf could be used to 
write an error routine. 


#include <stdio.h> 
#include <varargs.h> 


/* 

* error should be called like 

* error(function_name, format, argl, arg2...); 
*/ 

/*VARARGSO+/ 

void 


error(va_alist) 
/* Note that the function_name and format arguments 
* cannot be separately declared because of the 
* definition of varargs. 
va_del 
{ 
va_list args; 
char *fmt; 


VPRINTF (3S) 


va_start(args); 

/* print out name of function causing error */ 
(void)fprintf(stderr, "ERROR in %s: ”, va_arg(args, char *)); 
fmt = va_arg(args, char *); 

/* print out remainder of message */ 
(void)vfprintf(stderr, fmt, args); 
va_end(args); 

(void)abort(_ ); 
} 
SEE ALSO 
printf(3S), varargs(5). 
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NAME 
intro — introduction to file formats 


DESCRIPTION 
This section outlines the formats of various files. The C 
struct declarations for the file formats are given where 
applicable. Usually, these structures can be found in the 
directories /usr/include or /usr/include/sys. 


Entries suffixed by (4N) describe the configuration files 
used with the CTIX networking packages. These files 
can be manipulated directly (using a text editor) or with 
netman(1NM). 


SEE ALSO 
Internet Protocol Transition Workbook. Menlo Park, CA: 
Network Information Center, SRI International, 1982. 


CTIX Internetworking Manual. 


NAME 


A.OUT(4) 


a.out — common assembler and link editor output 


SYNOPSIS 


#include <a.out.h> 


DESCRIPTION 


The file name a.out is the output file from the 
assembler as(1) and the link editor /d(1). Both programs 
will make a.out executable if there were no errors in 
assembling or linking and no unresolved external 
references. 


A common object file consists of a file header, a CTIX 
system header, a table of section headers, relocation 
information, (optional) line numbers, a symbol table, and 
a string table. The order is given below. 


File header. 
CTIX system header. 
Section 1 header. 


Section n header. 
Section 1 data. 


Section n data. 
Section 1 relocation. 


Section n relocation. 
Section 1 line numbers. 


Section n line numbers. 
Symbol table. 
String table. 


The last three parts (line numbers, symbol table and 
string table) may be missing if the program was linked 
with the —s option of /d(1) or if they were removed by 
strip(1). Also note that the relocation information will 
be absent if there were no unresolved external references 
after linking. The string table exists only if the symbol 
table contains symbols with names longer than eight 
characters. 


The sizes of each section (contained in the header, 
discussed below) are in bytes and are even. 


When an a.out file is loaded into memory for execution, 
three logical segments are set up: the text segment, the 
data segment (initialized data followed by uninitialized, 
the latter actually being initialized to all 0’s), and a 
stack. The text segment begins at location 0x0000 in the 
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core image. The header is never loaded, except for 
magic 0413 files created with the —F option of /d(1). If 
the magic number (the first field in the operating system 
header) is 407 (octal), it indicates that the text segment 
is not to be write-protected or shared, so the data 
segment will be contiguous with the text segment. If the 
magic number is 410 (octal), the data segment and the 
text segment are not writable by the program; if other 
processes are executing the same a.out file, the processes 
will share a single text segment. Magic number 413 
(octal) is the same as 410 (octal), except that 413 (octal) 
permits demand paging. Both the —s and —F options of 
the loader Id(1) create a.out files with magic numbers 
0413. If the —z option is used, both the text and data 
sections of the file are on 1024-byte boundaries. If the 
—F option is used, the text and data sections of the file 
are contiguous. Loading a single 4096-byte page into 
memory requires 4 transfers of 1024 bytes each for —z, 
and typically one transfer of 4096 bytes for —F. Thus 
a.out files created with —F can load faster and require 
less disk space. 


The stack begins at the end of memory and grows 
towards lower addresses. The stack is automatically 
extended as required. The data segment is extended 
only as requested by the brk(2) system call. 


The value of a word in the text or data portions that is 
not a reference to an undefined external symbol is 
exactly the value that will appear in memory when the 
file is executed. If a word in the text involves a reference 
to an undefined external symbol, the storage class of the 
symbol-table entry for that word will be marked as an 
“external symbol’’, and the section number will be set to 
0. When the file is processed by the link editor and the 
external symbol becomes defined, the value of the 
symbol will be added to the word in the file. 


File Header 
The format of the filehdr header is 


A.OUT(4) 


struct filehdr 


{ 


hi 


unsigned short 
unsigned short 
long 
long 
long 
unsigned short 
unsigned short 


CTIX System Header 
The format of the CTIX system header is 


typedef struct aouthdr 


{ 


short magic; [* 
short vstamp; /* 


long 
long 
long 
long 
long 
long 


tsize; /* 
dsize; /* 
bsize; /* 


entry; /* 


f_magic; 
f_nsens; 
f_timdat; 
f_symptr; 
f_nsy ms; 
f_opthdr; 
f_flags; 


magic number */ 
version stamp */ 


/* magic number */ 

/* number of sections */ 
/* time and date stamp */ 
/* file ptr to symtab */ 

/* # symtab entries */ 

/* sizeof(opt hdr) */ 

/* flags */ 


text size in bytes, padded #/ 
initialized data (.data) */ 
uninitialized data (.bss) */ 


entry point */ 


text_start; /* base of text used for this file */ 
data_start; /* base of data used for this file */ 
} AOUTHDR; 


Section Header 
The format of the section header is 


struct scnhdr 


{ 


char 
long 
long 
long 
long 
long 
long 
unsigned short 
unsigned short 
long 


s_name|SYMNMLEN];/* section name +/ 


s_paddr; 
s_vaddr; 
8_size; 
s_scnptr; 
s_relptr; 
s_Innoptr; 
s_nreloc; 
s_ninno; 
s_flags; 


/* physical address */ 

/* virtual address */ 

/* section size */ 

/* file ptr to raw data */ 

/* file ptr to relocation */ 
/* file ptr to line numbers */ 
/* # reloc entries */ 

/* # line number entries */ 
/* flags */ 
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Relocation 
Object files have one relocation entry for each 
relocatable reference in the text or data. If relocation 
information is present, it will be in the following format: 


struct reloc 


{ 
long = r_vaddr;/* (virtual) address of reference */ 
long r_symndx; /* index into symbol table */ 
short r_type; /* relocation type */ 

}; 


The start of the relocation information is s_relptr from 
the section header. If there is no relocation information, 
s_relptr is 0. 

Symbol Table 
The format of each symbol in the the symbol table is 


#define SYMNMLEN 8 
#define FILNMLEN 14 


#define SYMESZ 18 /* the size of a SYMENT */ 
struct syment 
{ 
union /* get a symbol name #/ 
i 
char —n_name[SYMNMLEN]; /# name of symbol */ 
struct 
{ 
long _Nl_zeroes; /* == OL if in string table */ 
long _n_offset; /* location in string table */ 
} nn; 
char *_n_nptr(2|;  /* allows overlaying */ 
} on; 
unsigned long n_value; /* value of symbol */ 
short n_scnum; /* section number #/ 
unsigned short n_type; /* type and derived type */ 
char n_sclass; /* storage class +/ 
char n_numaux; /#* number of aux entries +/ 
} 
#define n_name _n._n_name 
#define n_zeroes _I._n_n._n_zeroes 
#define n_offset —n._n_n._n_offset 
#define n_nptr _n._n_nptr[l1] 


Some symbols require more information than a single 
entry; they are followed by auziliary entries that are the 
same size as a symbol entry. The format follows. 
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union auxent { 


struct { 
long x _tagndx; 
union { 
struct { 
unsigned short x_Jnno; 
unsigned short x_size; 
} x_Insz; 
long x_fsize; 
} x misc; 
union { 
struct { 
long x_lnnoptr; 
long x_endndx; 
} x_fen; 
struct { 
unsigned short x_dimen|DIMNUM|; 
} xary; 
} x_fenary; 
unsigned short x_tvndx; 
} x_sym; 
struct { 
char x_fname[FILNMLEN]; 
} x_Sfile; 
struct { 
long x _scenlen; 


unsigned short x_nreloc; 
unsigned short x_nlinno; 
} x_sen; 


struct { 
long x_tvfill; 
unsigned short x_tvlen; 
unsigned short x_tvran|2|; 
} x_ty; 
} 
Indexes of symbol table entries begin at zero. The start 
of the symbol table is f_.symptr (from the file header) 
bytes from the beginning of the file. If the symbol table 
is stripped, f_symptr is G. The string table (if one exists) 
begins at f_symptr + (f_nsyms * SYMESZ) bytes from 
the beginning of the file 


SEE ALSO 


ec(1), brk(2), filehdr(4), ldfen(4), linenum(4), 


as(1), ; 
M6 4), ot) eC), syms(4). 
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NAME 

acct — per-process accounting file format 
SYNOPSIS 

#include <sys/acct.h> 
DESCRIPTION 


Files produced as a result of calling acct(2) have records 


in the form defined by <sys/acct.h>, whose contents 
are: 


typedef ushort comp_t; /* “floating point” */ 


/* 13-bit fraction, 3-bit exponent */ 


struct acct 


{ 
char ac_flag; /* Accounting flag #/ 
char ac_stat; /* Exit status +/ 
ushort ac_uid; /* Accounting user ID */ 
ushort ac_gid; /* Accounting group ID +/ 
dev_t ac_tty; /* control typewriter */ 
time_t ac_btime; /#* Beginning time #/ 
comp_t ac_utime; /# acctng user time in clock ticks */ 
comp_t ac _stime; /* acctng system time in clock ticks */ 
comp_t ac_etime; /* acctng elapsed time in clock ticks */ 
comp_t ac_mem; /* memory usage in clicks */ 
comp_t ac_io; /* chars trnsfrd by read/write */ 
comp_t acirw; /* number of block reads/writes */ 
char ac_comm|8|; /* command name */ 

}s 


extern struct acct acctbuf; 
extern struct inode *acctp; /* inode of accounting file */ 


#define AFORK 01 /* has executed fork, but no exec */ 
#define ASU 02 /* used super-user privileges */ 
#define ACCTF 0300 /* record type: 00 = acct */ 


In ac_flag, the AFORK flag is turned on by each fork(2) 
and turned off by an ezec(2). The ac_comm field is 
inherited from the parent process and is reset by any 
exec. Each time the system charges the process with a 
clock tick, it also adds to ac_mem the current process 
size, computed as follows: 


(data size) + (text size) / (number of in-core 
processes using text) 


The value of ac_mem / (ac_stime + ac_utime) can be 
viewed as an approximation to the the resident-set size 
(or mean process size), defined as the total number of 
pages in memory. Note that this differs from the UNIX 
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System V formula, which is based on the current process 
size; such a formula is inappropriate to a paging 
environment. 


The structure tacct.h, which resides with the source files 
of the accounting commands, represents the total 
accounting format used by the various accounting 
commands: 


/* 

* total accounting (for acct period), also for day 

a} 

struct tacct { 
uid_t  ta_uid; /* userid */ 
char ta_name|8|; /* login name */ 
float ta_cpu[2];  /* cum. cpu time, p/np (mins) */ 
float ta_kcore(2];  /* cum kcore-minutes, p/np */ 
float  ta_con|2|; /* cum. connect time, p/np, mins */ 
float  ta_du; /* cum. disk usage */ 
long ta_pe; /* count of processes */ 
unsigned short ta_sc; /* count of login sessions */ 
unsigned short ta_de; /* count of disk samples */ 
unsigned short ta_fee;/* fee for special services +/ 

} 

SEE ALSO 


BUGS 


acct(1M), acctcom(1), acct(2), exec(2), fork(2). 


The ac_mem value for a short-lived command gives little 
information about the actual size of the command, 
because ac_mem may be incremented while a different 
command (e.g., the shell) is being executed by the 
process. 


— 


NAME 


AR(4) 


ar — common archive file format 


DESCRIPTION 


The archive command ar(1) is used to combine several 
files into one. Archives are used mainly as libraries to be 
searched by the link editor /d(1). 


Each archive begins with the archive magic string. 


#define ARMAG "!<arch>\n’” 
/* magic string */ 
#define SARMAG 8 
/* length of magic string */ 


Each archive which contains common object files (see 
a.out(4)) includes an archive symbol table. This symbol 
table is used by the link editor /d(1) to determine which 
archive members must be loaded during the link edit 
process. The archive symbol table (if it exists) is always 
the first file in the archive (but is never listed) and is 
automatically created and/or updated by ar. 


Following the archive magic string are the archive file 
members. Each file member is preceded by a file 
member header which is of the following format: 


#define ARFMAG "'\n” /* header trailer string */ 

struct ar_hdr /* file member header */ 

{ 
char ar_name([16]; /*'/' terminated file member name */ 
char ar_date[12\; /* file member date */ 
char ar_uid(6]; /* file member user identification */ 
char ar_gid(6]; /* file member group identification +*/ 
char ar_mode(8]; /* file member mode (octal) */ 
char ar_size[10]; /* file member size */ 
char ar_fmag|2]; /* header trailer string */ 

} 


All information in the file member headers is in printable 
ASCII]. The numeric information contained in the 
headers is stored as decimal numbers (except for 
ar_mode which is in octal). Thus, if the archive contains 
printable files, the archive itself is printable. 


The ar_name field is blank-padded and slash (/) 
terminated. The ar_date field is the modification date 
of the file at the time of its insertion into the archive. 
Common format archives can be moved from system to 
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system as long as the portable archive command ar(1) is 
used. Conversion tools such as arcv(1) and convert(1) 
exist to aid in the transportation of non-common format 
archives to this format. 


Each archive file member begins on an even byte 
boundary; a newline is inserted between files if 
necessary. Nevertheless the size given reflects the actual 
size of the file exclusive of padding. 


Notice there is no provision for empty areas in an 
archive file. 


If the archive symbol table exists, the first file in the 
archive has a zero length name (i.e., ar_name[0] == 
’/?). The contents of this file are as follows: 


° The number of symbols. Length: 4 bytes. 


® The array of offsets into the archive file. 
Length: 4 bytes * “‘the number of symbols”’. 


e The name string table. Length: ar_stze — (4 
bytes * (“the number of symbols” + 1)). 


The number of symbols and the array of offsets are 
managed with sgetl and sputl. The string table contains 
exactly as many null terminated strings as there are 
elements in the offsets array. Each offset from the array 
is associated with the corresponding name from the 
string table (in order). The names in the string table are 
all the defined global symbols found in the common 
object files in the archive. Each offset is the location of 
the archive header for the associated symbol. 


SEE ALSO 


BUGS 


ar(1), arev(l), convert(1), ld(1), strip(1), sputl(3X), 
a.out(4). 


Strip(1) will remove all archive symbol entries from the 
header. The archive symbol entries must be restored via 
the ts option of the ar(1) command before the archive 
can be used with the link editor /d(1). 


CHECKLIST (4) 


NAME 
checklist — list of file systems processed by fsck 


DESCRIPTION 
Checklist resides in directory /ete and contains a list of 
at most 15 spectal file names. Each special file name is 
contained on a separate line and corresponds to a file 
system. Each file system will then be automatically 
processed by the fsck(1M) command. 


SEE ALSO 
fsck(1M). 


CORE(4) 


NAME 
core — format of core image file 


DESCRIPTION 

CTIX writes out a core image of a terminated process 
when any of various errors occur. See stgnal(2) for the 
list of reasons; the most common are memory violations, 
illegal instructions, bus errors, and user-generated quit 
signals. The core image is called core and is written in 
the process’s working directory (provided it can be; 
normal access controls apply). A process with an 
effective user ID different from the real user ID will not 
produce a core image. 


The first section of the core image is a copy of the 
system’s per-user data for the process, including the 
registers as they were at the time of the fault. The size 
of this section depends on the parameter USIZE, which 
is defined in /usr/include/sys/page.h. The 
remainder represents the actual contents of the user’s 
core area when the core image was written. If the text 
segment is read-only and shared, or separated from data 
space, it is not dumped. 


The format of the information in the first section is 
described by the user structure of the system, defined in 
jue (include /aye/ weet The important stuff not 
detailed therein is the locations of the registers, which 
are outlined in /usr/include/sys/reg.h. 


SEE ALSO 
crash(1M), sdb(1), setuid(2), signal(2). 


NAME 


CPIO (4) 


cpio — format of cpio archive 


DESCRIPTION 


The header structure, when the —e option of epio(1) is 
not used, is: 


struct { 

short h_magic, 
_dev; 

ushort h_ino, 
h_mode, 
h_uid, 
h_gid; 

short h_nlink, 
h_rdev, 
h_mtime(2], 
h_namesize, 
h_filesize[2]; 

char h_name(h_namesize rounded to word]; 


} Har; 


When the —c option is used, the header information is 
described by: 


sscanf(Chdr, 

"%60%60%60% 60% 60% 60% 60% 60% 1 110% 60% 1 110%", 
&Hdr.h_magic, &Hdr.h_dev, &Hdr.h_ino, 
&Hdr.h_mode, &Hdr.h_uid, &Hdr.h_gid, 
&Hdr.h_nlink, &Hdr.h_rdev, &Longtime 
&Hdr.h_namesize,&Longfile,Hdr.h_name); 


Longtime and Longfile are equivalent to Hdr.h_mtime 
and Hdr.h_filesize, respectively. The contents of each 
file are recorded in an element of the array of varying 
length structures, archive, together with other items 
describing the file. Every instance of h_magie contains 
the constant 070707 (octal). The items h_dev through 
h_mtime have meanings explained in stat(2). The length 
of the null-terminated path name h_name, including the 
null byte, is given by h_nameasize. 


The last record of the archtve always contains the name 
TRAILER!!!. Special files, directories, and the trailer are 
recorded with h_ftilestze equal to zero. 


SEE ALSO 


epio(1), find(1), stat(2). 


NAME 


CPROFILE(4) 


cprofile — setting up a C shell environment at login time 


DESCRIPTION 


FILES 


eprofile is for use with esh(1). For every user of esh the 
system file /etc/eprofile is executed immediately upon 
login. If the user’s login directory contains a file named 
-cshre, that file will then be executed, followed by 
commands from the .login file. 


The following example is typical for a user’s .eshre file: 


setenv PATH :$PATH:$HOME/bin 
setenv MAIL /usr/mail/myname 
setenv TERM pt 

umask 022 


The system file /ete/eprofile can be customized to set 
the TERM environment variable via tset(1) and to 
automatically invoke wm(1) on RS-422 terminals. 


For further information about setting variables, see 
csh(1) and sh(1). 


$HOME/.login 
$HOME/.cshre 
$HOME/. logout 
/etc/cprofile 


SEE ALSO 


esh(1), cprofile(4), env(1), login(1), mail(1), sh(1), stty(1), 
sa tset(1), wm(1), ttytype(4), environ(5), term(5). 
MightyFrame Admintstrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 
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NAME 
dir — format of directories 


SYNOPSIS 
#include <sys/dir.h> 

DESCRIPTION 
A directory behaves exactly like an ordinary file, save 
that no user may write into a directory. The fact that a 
file is a directory is indicated by a bit in the flag word of 
its inode entry (see fs(4)). The structure of a directory 
entry as given in the include file is: 


#ifndef DIRSIZ 
#define DIRSIZ14 
#endif 


struct direct 


ino_t d_ino 
char d “pame(DIRSIZ]; 
By convention, the first two entries in each directory are 
for. and... The first is an entry for the directory itself. 
The second is for the parent directory. The meaning of 
.. is modified for the root directory of the master file 


system; there is no parent, so... has the same meaning 
as .. 


SEE ALSO 


fs(4). 
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NAME 
errfile — error-log file format 


SYNOPSIS 
#include <sys/erec.h> 


DESCRIPTION 
When hardware errors are detected by the system, an 
error record is generated and passed to the error-logging 
daemon for recording in the error log for later analysis. 
The default error log is /usr/adm/errfile. 


The format of an error record depends on the type of 
error that was encountered. Every record, however, has 
a header with the following format: 


struct errhdr { 
short e_type; /* record type */ 
short e_len; /* bytes in record (ine hdr) */ 
time_t e_time; /* time of day */ 


The permissible record types are as follows: 


#define ELGOTS 010 /* start */ 

#define ESTOP 012 /* stop */ 

#define E-TCHG 013 /* time change */ 

#define ELCCHG 014 /* configuration change */ 
#define E_BLK 020 /* block device error */ 
#define ESSTRAY 030 /* stray interrupt */ 
#define ELPRTY 031 /* memory parity */ 
#define E.BUSFLT 032 /* bus fault */ 

#define ELCONS 040 /* console string */ 
#define EL.CONR 041 /* console record */ 
#define ELCONO 042 /* console overflow */ 
#define ELSERIAL 043 /* serial device driver error */ 


Some records in the error file are of an administrative 
nature. These include the startup record that is entered 
into the file when logging is activated, the stop record 
that is written if the daemon is terminated “gracefully”, 
and the time-change record that is used to account for 
changes in the system’s time-of-day. These records have 
the following formats: 
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struct estart { 


short e_cpu; /* CPU type *#/ 

struct utsname e_name; /* system names «/ 

short e_mmr3; /* boot reason from CDT +/ 

long e_syssize; /* system memory size */ 

int efhole; /* 64K chunks of memory omitted */ 
short e_bconf; /* block dev configuration +*/ 

char e_panic; /* if reboot from panic, what was it */ 


hi 
#define eend errhdr /* record header */ 


struct etimchg { 
time_t e_ntime; /* new time */ 
}i 


Stray interrupts cause a record with the following format 
to be logged: 


struct estray { 


physadr e_saddr; /* stray loc or device addr */ 
short e_sbacty; /* active block devices */ 


} 

Memory subsystem error causes the following record to 
be generated: 

For MintFrame systems: 


struct eparity { 

ushort e_gsr; /# general status register */ 

ushort e pte; /* pte for virtual address in BSR */ 
} 
For MightyFrame systems: 


struct eparity { 
uint e_gsr; /* general status register */ 
hi 


Error records for block devices have the following 
format: 
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struct eblock { 
dev_t  e_dev; /* “true” major + minor dey no */ 
physadr e_regloc; /* controller address */ 
short e_bacty; /* other block I/O activity */ 
struct iostat { 
long io_ops; /* number read/writes */ 
long io_misc; /* number “other” operations */ 
ushortio_unlog; /* number unlogged errors */ 
} e_stats; 
short e_bflags; /* read/write, error, etc */ 
short e_trkoff; /* logical dev start trk */ 
daddr_t e_bnum; /* logical block number */ 
ushort e_bytes; /* number bytes to transfer ¢/ 
paddr_t e_memadd;/* buffer memory address */ 
ushort e_rtry; /* number retries */ 
short e_nreg; /* number device registers */ 
short e_trks /* number of heads */ 
short e_secs /* number of physical sectors per track */ 
short = e_etir /* controller type */ 
} 
The following values are used in the e_bflage word: 


#define E.WRITE 0 /* write operation * 
#define ERREAD 1 /* read operation * 
#define E.NOIO 02 /* no I/O pending */ 
#define E.PHYS 04 /* physical 1/0 */ 
#define ELMAP 010 /* Unibus map in use */ 
#define ELERROR 020 /* 1/0 failed */ 


The error types CONS and CONO are flagged by 
errdemon(1M) and errdead and written to the console 


log /ete/log/confile. 
A bus fault generates the following record. 
struct ebusflt { 


short e_type; /* kind of fault */ 
caddr_t e_vaddr /* virtual address of fault */ 


uint e_bsr; /* combined bsr0 and bsr1 */ 
ushort e_pte; /* page frame of fault */ 
ushort e_pid; /* pid */ 

uint e_pe; /* PC at time of fault */ 
uint e_rps; /* RPS at time of fault */ 


uint e_regs|[16]; /* all the registers */ 
; 
A serial driver error generates the following reports: 


struct eserial { 
ushort e_type /* type of error */ 
ushort e_dev /* which physical port */ 
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}; 

The following types exist for e_type: 

#define ECHLOS Ox1 /* character lost in input FIFO */ 

#define ERXORUN 0x2 /* receiver overrun */ 

#define ENOCLIST 0x4 /* no new clist available */ 

#define ENORBUF 0x8 /* no receive buffer available */ 
SEE ALSO 

errdemon(1M). 
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filehdr — file header for common object files 


SYNOPSIS 


#finclude <filehdr.h> 


DESCRIPTION 


Every common object file begins with a 20-byte header. 
The following C struct declaration is used: 


struct filehdr 


unsigned short f_magic; /* magic number */ 
unsigned short f_nsens; /* number of sections */ 
long f_timdat; /* time & date stamp */ 
long f_symptr; /* file ptr to symtab */ 
long f_nsyms; /* # symtab entries */ 
unsigned short f_opthdr; —_/* sizeof(opt hdr) */ 
unsigned short f_flags; /* flags va 


i 
F_symptr is the byte offset into the file at which the 
symbol table can be found. Its value can be used as the 
offset in fseek(3S) to position an I/O stream to the 
symbol table. The operating system optional header is 
always 36 bytes. The valid magic numbers are given 
below. 
#define MC68KWRMAGIC 0520 

/* writeable text segments */ 
#define MC68KROMAGIC 0521 

/* readonly shareable text segments */ 
#define MC68KPGMAGIC 0522 

/* demand paged text segments */ 


The value in f_timdat is obtained from the time(2) 
system call. 
Flag bits currently defined are: 
#define F_LRELFLG 00001 
/* relocation entries stripped */ 


#define F_EXEC 00002 
/* file is executable */ 
#define F_LNNO 00004 


/* line numbers stripped */ 
#define F_LLSYMS 00010 

/* local symbols stripped */ 
# define F_MINMAL 00020 

/* minimal object file *«/ 
#define F_LUPDATE 00040 

/* update file, ogen produced */ 
#define F_SWABD 00100 
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/* file is "pre-swabbed” */ 
#define F_AR32W 01000 

/* non-DEC host, 

including Convergent 

Technologies systems */ 
# define F_PATCH 02000 

/* “patch” list in opt hdr */ 
The CPU type is encoded in bits 04000 and 010000. The 
FPU (floating-point unit) type is encoded in_ bits 
0100000, 040000, and 020000. Macros are defined to set 
and extract the CPU and FPU values as follows: 


SETFPU(flag, value 
SETCPU(flag, value 
GETFPU(flag 
GETCPU(flag 


Value values for CPU are: 


# define F_M68010 0 
# define F_M68020 1 


Valid values for FPU are: 


# define F_NOFPU 
#define F_SOFT 
# define F_M68881 
#define F_SKY 


Ce) 


SEE ALSO 
time(2), fseek(3S), a.out(4). 
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NAME 
fs — file system format 


SYNOPSIS 
#include <sys/filsys.h> 
#include <sys/types.h> 
#include <sys/param.h> 
#include <sys/filbitmap.h> 


DESCRIPTION 
Every file system storage volume has a common format 
for certain vital information. Every such volume is 
divided into a certain number of 512-byte long sectors. 
Sector 0 is unused and is available to contain a bootstrap 
program or other information. 


Sector 1 is the super-block. The format of a super-block 


1S: 

/* 

* Structure of the super-block 

*/ 

struct filsys 
ushort  s_isize; /* size in blocks of i-list */ 
daddr_t s_fsize; /* size in blocks of entire volume */ 
short —s_nfree; /* number of addresses in s_free */ 
daddr_t s_free|NICFREE]; /* free block list */ 
short —_s_ninode; /* number of i-nodes in s_inode */ 
ino_t — s_inode{NICINOD}; /* free i-node list */ 
char s_flock; /* lock during free list manipulation */ 
char s_ilock; /* lock during i-list manipulation +*/ 
char s_fmod; /* super block modified flag */ 
char s_ronly; /* mounted read-only flag */ 
time_t s_time; /* last super block update */ 
short s_dinfo[4|; —/* device information */ 
daddr_t s_tfree; /* total free blocks*#/ 
ino_t s_tinode; /* total free i-nodes */ 
char s_fname[6|]; —/* file system name */ 
char s_fpack|[6]; /* file system pack name +/ 


sema_t s_semflock; 

sema_t s_semilock; 

long s_file|1]; 

short — s_fills; /* more adjust */ 

short s_buenum; /* Bucket currently in use */ 
daddr_t s_buckets[2]; /* addresses of buckets for bitmap */ 
daddr_t s_bitmap[2|; /* address of free bitmap */ 


char sfsbitmap; /* if set, file system has 

a valid bitmap */ 
char s_fsok; /* if set then file system clean */ 
short —_s_fill2[3]; /* used to be used by pilf */ 
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long s_magic; /* magic number to denote new 
file system */ 
long s_type; /* type of new file system */ 
long _—_s_fill3(2]; /* final ADMUSTMENT so 
sizeof filsys is 512 */ 
se 
#define FsMAGIC Oxfd187e20 /* s_magic number */ 
#define Fslb 1 /* 512 byte block */ 
#define Fs2b 2 /* 1024 byte block */ 


CTIX recognizes two kinds of file systems, specified by 

s_type: 

e Oriented to 512-byte I/O. Identified by an 
s_type equal to Fs1b. This type is also assumed 
if s_magic is not equal to FsMAGIC. (This 
type was originally the only type supported by 
UNIX Systems; CTIX does not support this type.) 


° Oriented to 1024-byte I/O. Identified by an 
s_type equal to Fs2b. This is essentially the 
standard file system for CTIX and UNIX System 
V. 


In the following description, the size of a logical block is 
determined by the file system type. For the original 
512-byte oriented file system, a block is 512 bytes. For 
the 1024-byte oriented file system a block is 1024 bytes 
or two sectors. The operating system takes care of all 
conversions from logical block numbers to physical sector 
numbers. 


S_isize is the address of the first data block after the i- 
list; the i-list starts just after the super-block, namely in 
block 2; thus the i-list is s_tstze—2 blocks long. S_fstze 
is the first block not potentially available for allocation 
to a file. These numbers are used by the system to 
check for bad block numbers; if an ‘‘impossible’’ block 
number is allocated from the free list or is freed, a 
diagnostic is written on the on-line console. Moreover, 
the free array is cleared, so as to prevent further 
allocation from a presumably corrupted free list. 


The free list for each volume is maintained as follows. 
The s_free array contains, in s_free(l], ... 
s_free[s_nfree—1], up to 49 numbers of free blocks 
S_free 0] is the block number of the head of a chain of 
blocks constituting the free list. The first long in each 
free-chain block is the number (up to 50) of free-block 
numbers listed in the next 50 longs of this chain 
member. The first of these 50 blocks is the link to the 
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next member of the chain. To allocate a_ block: 
decrement s_nfree, and the new block is s_free[s_nfree]. 
If the new block number is 0, no blocks remain, so give 
an error. If s_nfree became 0, read in the block named 
by the new block number, replace s_nfree by its first 
word, and copy the block numbers in the next 50 longs 
into the s_free array. To free a block, check if s_nfree 
is 50; if so, copy s_nfree and the s_free array into it, 
write it out, and set s_nfree to 0. In any event set 
s_free[s_ nfree! to the freed block’s number and 
increment s_nfree. 


S_tfree is the total free blocks available in the file 
system. 


S_ninode is the number of free i-numbers in the s_inode 
array. To allocate an i-node: if s_ninode is greater than 
0, decrement it and return poinodeleniiode| If it was 
0, read the i-list and place the numbers of all free i-nodes 
sup to 100) into the s_tnode array, then try again. To 
ree an i-node, provided s_ninode is less than 100, place 
its number into s_inode{s_ninode| and increment 
s_ninode. If s_ninode is already 100, do not bother to 
enter the freed i-node into any table. This list of i-nodes 
is only to speed up the allocation process; the 
information as to whether the i-node is really free or not 
is maintained in the i-node itself. 


S_tinode is the total free i-nodes available in the file 
system. 


S_flock and s_ilock are flags maintained in the core copy 
of the file system while it is mounted and their values on 
disk are immaterial. The value of s_fmod on disk is 
likewise immaterial; it is used as a flag to indicate that 
the super-block has changed and should be copied to the 
disk during the next periodic update of file system 
information. 


S_ronly is a read-only flag to indicate write-protection. 


S_time is the last time the super-block of the file system 
was changed, and is the number of seconds that have 
elapsed since 00:00 Jan. 1, 1970 (GMT). During a reboot, 
the s_ttme of the super-block for the root file system is 
used to set the system’s idea of the time. 


S_fname is the name of the file system and s_fpack is 
the name of the pack. 


I-numbers begin at 1, and the storage for i-nodes begins 
in block 2. Also, i-nodes are 64 bytes long. I-node 1 is 
reserved for future use. I-node 2 is reserved for the root 
directory of the file system, but no other i-number has a 
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built-in meaning. Each i-node represents one file. For 
the format of an i-node and its flags, see tnode(4). 


The s_fsok flag indicates that the file system was 
unmounted after the last use, or that fsck was run 
successfully. The s_fsbitmap flag indicates that the file 
system has a valid bitmap describing a number of blocks 
that are omitted from the free list; these blocks are 
placed on the bitmap (filbitmap.h). If both flags are 
set, CTIX uses the bitmap; otherwise the old free list is 
used and any blocks that were in the bitmap (not on the 
free list) will be lost until fsck is run. 


s_buckets and s_bitmap are the disk addresses of the 
filbitmap structure; each address is for a 1024-byte logical 
block. 


All allocations of blocks are made from the bitmap. If a 
block being deallocated is in the section of the disk 
represented by s_bucknum, it is put in the bitmap. If 
the block is not in the area represented by the bitmap, it 
is put on the free list. 


The format of the file system bitmap and bucket list is: 


struct filbitmap { 
/* list of buckets describing the free list */ 
ushort fb_buckets[1024]; 
(° bitmap describing free blocks no on the free list */ 
ong fb_bitmap[512); 


? 


/usr/include/sys/filsys.h 
/usr/include/sys/stat.h 
/usr/include/sys/filbitmap.h 


SEE ALSO 


fsck(1M), fsdb(1M), mkfs(1M), inode(4). 
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fspec — format specification in text files 


DESCRIPTION 


It is sometimes convenient to maintain text files on CTIX 
with non-standard tabs, (i.e., tabs which are not set at 
every eighth column). Such files must generally be 
converted to a standard format, frequently by replacing 
all tabs with the appropriate number of spaces, before 
they can be processed by CTIX commands. A format 
specification occurring in the first line of a text file 
specifies how tabs are to be expanded in the remainder 
of the file. 


A format specification consists of a sequence of 
parameters separated by blanks and surrounded by the 
brackets <: and :>. Each parameter consists of a 
keyletter, possibly followed immediately by a value. The 
following parameters are recognized: 


ttabs The t parameter specifies the tab settings 
for the file. The value of tabs must be one 
of the following: 


1. a list of column numbers separated by 
commas, indicating tabs set at the 
specified columns; 


2. a — followed immediately by an 
integer n, indicating tabs at intervals 
of n columns; 


3. a — followed by the name of a 
“canned” tab specification. 


Standard tabs are specified by t-—8, or 
equivalently, t1,9,17,25,etc. The canned 
tabs which are recognized are defined by the 
tabs(1) command. 


B8tze The s parameter specifies a maximum line 
size. The value of stze must be an integer. 
Size checking is performed after tabs have 
been expanded, but before the margin is 
prepended. 


mmargin The m parameter specifies a number of 
spaces to be prepended to each line. The 
value of margin must be an integer. 


d The d parameter takes no value. Its 
presence indicates that the line containing 
the format specification is to be deleted 
from the converted file. 
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e The e parameter takes no value. Its 
presence indicates that the current format is 
to prevail only until another format 
specification is encountered in the file. 


Default values, which are assumed for parameters not 
supplied, are t-8 and mO. If the s parameter is not 
specified, no size checking is performed. If the first line 
of a file does not contain a format specification, the 
above defaults are assumed for the entire file. The 
following is an example of a line containing a format 
specification: 


* <:t5,10,15 s72:> * 
If a format specification can be disguised as a comment, 
it is not necessary to code the d parameter. 


Several CTIX commands correctly interpret the format 
specification for a file. 

SEE ALSO 
ed(1), newform(1), tabs(1). 
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NAME 
gettydefs — speed and terminal settings used by getty 


DESCRIPTION 
The /etc/gettydefs file contains information used by 
getty(1M) to set up the speed and terminal settings for a 
line. It supplies information on what the login prompt 
should look like. It also supplies the speed to try next if 
the user indicates the current speed is not correct by 
typing a <break> character. 


Each entry in /ete/gettydefs has the following format: 


label# initial-flags # final-flags # login-prompt 
#next-label 


Each entry is followed by a blank line. The various 
fields can contain quoted characters of the form \b, \n, 

c, etc., as well as \nnn, where nnn is the octal value of 
the desired character. The various fields are: 


label This is the string against which getty tries 
to match its second argument. It is often 
the speed, such as 1200, at which the 
terminal is supposed to run, but it need 
not be (see below). 


inttial-flags | These flags are the initial tocti(2) settings 
to which the terminal is to be set if a 
terminal type is not specified to getty. 
The flags that getty understands are the 
same as the ones _ listed in 
/usr /include/sys/termio.h ce 
termto(7)). Normally only the speed flag 
is required in the intétal-flags. Getty 
automatically sets the terminal to raw 
input mode and takes care of most of the 
other flags. The intttal-flag settings 
remain in effect until getty executes 
login(1). 

final-flags These flags take the same values as the 
tnttial-flags and are set just prior to getty 
executes login. The speed flag is again 
required. The composite flag SANE 
takes care of most of the other flags that 
need to be set so that the processor and 
terminal are communicating in a rational 
fashion. The other two commonly 
specified final-flags are TAB3, so that 
tabs are sent to the terminal as spaces, 
and HUPCL, so that the line is hung up 
on the final close. 


a ee 


FILES 


GETTYDEFS (4) 


login-prompt This entire field is printed as the login- 
prompt. Unlike the above fields where 
white space is ignored (a space, tab or 
new-line), they are included in the login- 
prompt field. 


neat-label If this entry does not specify the desired 
speed, indicated by the user typing a 
<break> character, then getty will 
search for the entry with nezt-label as its 
label field and set up the terminal for 
those settings. Usually, a series of speeds 
are linked together in this fashion, into a 
closed set; for instance, 2400 linked to 
1200, which in turn is linked to 300, 
which finally is linked to 2400. 


If getty is called without a second argument, then the 
first entry of /ete/gettydefs is used, thus making the 
first entry of Jete getty defs the default entry. It is 
also used if getty can not find the specified label. If 
/ etc/gettydefs itself is missing, there is one entry built 
into the command which will bring up a terminal at 
9600 baud. 


It is strongly recommended that after making or 
modifying /ete/gettydefs, it be run through getty with 
the check option to be sure there are no errors. 


/etc/gettydefs 


SEE ALSO 


getty(1M), login(1), ioctl(2), termio(7). 
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gps — graphical primitive string, format of graphical files 


DESCRIPTION 


GPS is a format used to store graphical data. Several 
routines have been developed to edit and display GPS 
files on various devices. Also, higher level graphics 
programs such as plot (in stat(1G)) and vtoc (in 
toe(1G)) produce GPS format output files. 


A GPS is composed of five types of graphical data or 
primitives. 


GPS PRIMITIVES 


lines The (ines primitive has a variable number of 
points from which zero or more connected 
line segments are produced. The first point 
given produces a move to that location. (A 
move is a relocation of the graphic cursor 
without crowing) Successive points produce 
line segments from the previous point. 
Parameters are available to set color, weight, 
and style (see below). 


arc The are primitive has a variable number of 
points to which a curve is fit. The first point 
produces a move to that point. If only two 
points are included, a line connecting the 
points will result; if three points a circular arc 
through the points is drawn; and if more than 
three, lines connect the points. (In the 
future, a spline will be fit to the points if 
they number greater than three.) Parameters 
are available to set color, wetght, and style. 


text The tezt primitive draws characters. It 
requires a single point which locates the 
center of the first character to be drawn. 
Parameters are color, font, textsize, and 
teztangle. 


hardware 
The hardware primitive draws hardware 
characters or gives control commands to a 
hardware device. A single point locates the 
beginning location of the hardware string. 


comment A comment is an integer string that is 
included in a GPS file but causes nothing to 
be displayed. All GPS files begin with a 
comment of zero length. 
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GPS PARAMETERS 


color Color is an integer value set for arc, lines, 
and tezt primitives. 
weight Weight is an integer value set for are and 
lines primitives to indicate line thickness. 
The value O is narrow weight, 1 is bold, and 
2 is medium weight. 
style Style is an integer value set for lines and arc 
primitives to give one of the five different 
line styles that can be drawn on TEKTRONIX 
4010 series storage tubes. They are: 
0 solid 
1 dotted 
2 dot dashed 
3 dashed 
4 long dashed 
font An integer value set for tezt primitives to 
designate the text font to be used in drawing 
a character string. (Currently font is 
expressed as a four-bit wetght value followed 
by a four-bit style value.) 
textsize Textsize is an integer value used in tezt 
primitives to express the size of the 
characters to be drawn. Teztstze represents 
the height of characters in absolute untverse- 
units and is stored at one-fifth this value in 
the size-orientation (so) word (see below). 
textangle Teztangle is a signed integer value used in 
text primitives to express rotation of the 
character string around the beginning point. 
Textangle is expressed in degrees from the 
positive x-axis and can be a positive or 
negative value. It is stored in the size- 
orientation (so) word as a value 256/360 of 
it’s absolute value. 
ORGANIZATION 
GPS primitives are organized internally as follows: 
lines cw potnts sw 
are cw points sw 
text cw point sw so [string | 
hardware ew point [string | 
comment cw lating 
cw Cw is the control word and begins all 


primitives. It consists of four bits that 
contain a primitive-type code and twelve bits 
that contain the word-count for that 
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point(s) 


sw 


so 


string 
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primitive. 

Point(s) is one or more pairs of integer 
coordinates. Tezt and hardware primitives 
only require a single potnt. Potni{s) are 
values within a Cartesian plane or universe 
having 64K (-32K to +32K) points on each 
axis. 


Sw is the style-word and is used in lines, arc, 
and tezt primitives. For all three, eight bits 
contain color information. In are and lines 
eight bits are divided as four bits wetght and 
four bits style. In the tezt primitive eight bits 
of sw contain the font. 


So is the size-orientation word used in tezt 
primitives. Eight bits contain text size and 
eight bits contain text rotation. 


String is a null-terminated character string. 
If the string does not end on a _ word 
boundary, an additional null is added to the 
GPS file to insure word-boundary alignment. 


graphics(1G), stat(1G), toc(1G). 
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NAME 
group — group file 
DESCRIPTION 
Group contains for each group the following information: 
group name 
encrypted password 


numerical group ID 
comma-separated list of all users allowed in the group 


This is an ASCII file. The fields are separated by colons; 
each group is separated from the next by a new-line. 
the password field is null, no password is demanded. 
This file resides in directory /ete. Because of the 
encrypted passwords, it can and does have general read 
permission and can be used, for example, to map 
numerical group ID’s to names. 

FILES 
/etc/group 

SEE ALSO 
newgrp(1), passwd(1), crypt(3C), passwd(4). 


NAME 
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hosts — list of nodes on network 


DESCRIPTION 


The file /etc/hosts is a list of nodes that share the 
network, including the local node. It is referred to by 
programs which need to translate between node names 
and DARPA Internet addresses. Each line in the file 
describes a single node on the network and consists of 
three fields separated by any number of blanks or tabs: 


address name alias ... 


where 
address 


name 


aliases... 


is the DARPA Internet address. 
Unless another type of address is 
required by some node on the 
network, address should be a Class 
A address, which takes the form 
net.node, where net is the network 
number from /etc/networks (see 
networks(4)), which must be betwen 
O and 127; and node is a value 
which must be unique for each node 
and be between 0 and 16777215. 


is the official name of the node. If 
the node is a computer system 
running CTIX , it must claim this 
node name by executing 
setuname(1M) when it is initializing 
itself. 


is a list of alternate names for the 
node. Aliases can be used in 
network commands in place of the 
official name. 


The routines which search this file ignore comments 
(portions of lines beginning with #) and blank lines. 


Internet addresses can actually take one of four forms: 


A 
A.B 


A.B.C 


A is a simple 32-bit integer. 

A is an eight-bit quantity occupying 
the high-order byte and B is a 24-bit 
quantity occupying the remaining 
bytes. This form is suitable for a 
Class A address of the form 
net.node. 

A is an eight-bit quantity occupying 
the high-order byte; B is an eight-bit 
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quantity occupying the next byte; 
and C is a 16-bit quantiy occupying 
the remaining bytes. This form is 
suitable for a Class B address of the 
form 128.net.node. 


A.BC.D The four parts each occupy a byte in 
the address. 


EXAMPLE 
# Engineering network 


1.12 src net3 # Network Source Machine 
1.10 test net2 # Network Test Machine 


1.16 mifa # Software Development 
1.17 mifb # Hardware Development 
FILES 
/etc /hosts 
SEE ALSO 
networks(4N). 
CTIX Internetworking Manual. 
For a discussion of network addresses, see ‘Address 
Mappings,’’ RFC 796 in the Internet Protocol Transition 
Workbook, March 1982. Network Information Center, 
SRI International, Menlo Park, CA 94025. 
NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NAME 


INITTAB(4) 


inittab — script for the init process 


DESCRIPTION 


The tnittab file is the script to tnit’s role as a general 
process dispatcher. The process that constitutes the 
majority of tintt’s process dispatching activities is the line 
process /etc/getty that initiates individual terminal 
lines. Other processes typically dispatched by tntt are 
daemons and the shell. 


The inittab file is composed of entries that are position 
dependent and have the following format: 


id:rstate:action:process 


Each entry is delimited by a newline, however, a 
backslash (\) preceding a newline indicates a 
continuation of the entry. Up to 512 characters per 
entry are permitted. Comments may be inserted in the 
process field using the sh(1) convention for comments. 
Comments for lines that spawn gettys are displayed by 
the who(1) command. It is expected that they will 
contain some information about the line such as the 
location. There are no limits (other than maximum 
entry size) imposed on the number of entries within the 
tnittab file. The entry fields are: 


id This is one to four characters used to uniquely 
identify an entry. 


retate | This defines the run-level in which this entry is 
to be processed. Run-levels effectively 
correspond to a configuration of processes in 
the system. That is, each process spawned by 
init is assigned a run-level or run-levels in 
which it is allowed to exist. The run-levels are 
represented by a number ranging from O 
through 6. As an example, if the system is in 
run-level 1, only those entries having a 1 in the 
rstate field will be processed. When init is 
requested to change run-levels, all processes 
which do not have an entry in the rstate field 
for the target run-level will be sent the warning 
signal (SIGTERM) and allowed a 20second 
grace period before being forcibly terminated 
by a kill signal apeneeer The rstate field 
can define multiple run-levels for a process by 
selecting more than one run-level in any 
combination from O-6. If no run-level is 
specified, then the process is assumed to be 
valid at all run-levels O-6. Three other values, 


Pe ee 


action 
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a, b and ¢, can appear in the rstate field, even 
though they are not true run-levels. Entries 
which have these characters in the rstate field 
are processed only when the telmnit (see 
init(1M)) process requests them to be run 
(regardless of the current run-level of the 
system). They differ from run-levels in that 
tntt can never enter run-level a, b or c. Also, a 
request for the execution of any of these 
processes does not change the current run-level. 
Furthermore, a process started by an a, b orc 
command is not killed when tntt changes levels. 
They are only killed if their line in 
/etc/inittab is marked off in the action field, 
their line is deleted entirely from /ete/inittab, 
or tntt goes into the SINGLE USER state. 


Key words in this field tell intt how to treat the 
process specified in the process field. The 
actions recognized by tntt are as follows: 


respawn If the process does not exist then 
start the process, do not wait for 
its termination (continue 


scanning the tntttab file), and 
when it dies restart the process. 
If the process currently exists 
then do nothing and continue 
scanning the tnittad file. 


wait Upon tntt’s entering the run-level 
that matches the entry’s rstate, 
start the process and wait for its 
termination. All — subsequent 
reads of the tntttab file while init 
is in the same run-level will cause 
intt to ignore this entry. 


once Upon intt’s entering a run-level 
that matches the entry’s rstate, 
start the process, do not wait for 
its termination. When it dies, do 
not restart the process. If upon 
entering a new run-level, where 
the process is still running from a 
previous run-level change, the 
program will not be restarted. 


boot The entry is to be processed only 
at tnit’s boot-time read of the 
intttab file. Init is to start the 
process, not wait for its 


-2- 


INITTAB(4) 


bootwait 


powerfail 


powerwait 


off 


ondemand 


initdefault 


termination, and when it dies, 
not restart the process. In order 
for this instruction to be 
meaningful, the rstate should be 
the default or it must match 
tnit’s) run-level at boot time. 
This action is useful for an 
initialization function following a 
hardware reboot of the system. 


The entry is to be processed only 
at intt’s boot-time read of the 
intttab file. Jntt is to start the 
process, wait for its termination 
and, when it dies, not restart the 
process. 


Execute the process associated 
with this entry only when init 
receives a power fail signal 
(SIGPWR see signal(2)). 


Execute the process associated 
with this entry only when init 
receives a power fail signal 
(SIGPWR) and wait until it 
terminates before continuing any 
processing of tntttab. 


If the process associated with this 
entry is currently running, send 
the warning signal (SIGTERM) 
and wait 20 seconds _ before 
forcibly terminating the process 
via the kill signal (SIGKILL). If 
the process is nonexistent, ignore 
the entry. 


This instruction is really a 
synonym for the respawn action. 
It is functionally identical to 
respawn but is given a different 
keyword in order to divorce its 
association with run-levels. This 
is used only with the a, b or ¢ 
values described in the rstate 
field. 


An entry with this action is only 
scanned when init _ initially 
invoked. Init uses this entry, if it 
exists, to determine which run- 


sysinit 
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level to enter initially. It does 
this by taking the highest run- 
level specified in the rstate field 
and using that as its initial state. 
If the rstate field is empty, this is 
interpreted as 0123456 and so 
tnit will enter run-level 6. Also, 
the initdefault entry cannot 
specify that inzt start in the 
SINGLE USER state. 
Additionally, if intt does not find 
an initdefault entry in 
/etc/inittab, then it will request 
an initial run-level from the user 
at reboot time. 


Entries of this type are executed 
before tnit tries to access the 
console. It is expected that this 
entry will be only used _ to 
initialize devices on which init 
might try to ask the run-level 
question. These’ entries are 
executed and waited for before 
continuing. 


process This is a sh command to be executed. The 
entire process field is prefixed with exec and 
passed to a forked sh as sh -c ‘exec 
command'. For this reason, any legal sh syntax 
can appear in the process field. Comments can 
be inserted with the ; #comment syntax. 


FILES 
/etc/inittab 
SEE ALSO 


getty(1M), init(1M), sh(1), who(1), exec(2), open(2), 


signal(2). 
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NAME 
inode — format of an i-node 
SYNOPSIS 
#include <sys/types.h> 
#include <sys/ino.h> 
DESCRIPTION 
An i-node for a plain file or directory in a file system has 
the following structure defined by <sys/ino.h>. 


/* Inode structure as it appears on a disk block. */ 
struct dinode 


{ 
ushort di_mode; /* mode and type of file */ 
short di_nlink; /* number of links to file «/ 
ushort  di_uid; —/* owner's user id */ 
ushort di_gid; /* owner’s group id */ 
off_t di_size; /* number of bytes in file */ 
char di_addr{40]; /* disk block addresses */ 
time_t di_atime; /* time last accessed */ 
time_t  di_mtime;/* time last modified */ 
time_t  di_ctime; /* time of last file status change */ 
}; 
/* 
* the 40 address bytes: 
* 39 used; 13 addresses 
* of 3 bytes each. 
*/ 


For the meaning of the defined types off_t and time_t 
see types(5). 
FILES 
/usr/include/sys/ino.h 
SEE ALSO 
stat(2), fs(4), types(5). 


ISSUE(4) 


NAME 
issue — issue identification file 


DESCRIPTION 
The file /ete/issue contains the issue or project 
identification to be printed as a login prompt. This is an 
ASCII file which is read by program getty and then 
written to any terminal spawned or respawned from the 
/etc/inittab file. 


FILES 
/etc /issue 


SEE ALSO 
login(1). 
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NAME 


LDFCN(4) 


Idfen — common object file access routines 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


DESCRIPTION 


The common object file access routines are a collection 
of functions for reading an object file that is in common 
object file form. Although the calling program must 
know the detailed structure of the parts of the object file 
that it processes, the routines effectively insulate the 
calling program from knowledge of the overall structure 
of the object file. 


The interface between the calling program and the 
object file access routines is based on the defined type 
LDFILE, defined as struct Idfile, declared in the header 
file ldfen.h. The primary purpose of this structure is to 
provide uniform access to both simple object files and to 
object files that are members of an archive file. 


The function /dopen(3X) allocates and initializes the 
LDFILE structure and returns a pointer to the structure 
to the calling program. The fields of the LDFILE 
structure may be accessed individually through macros 
defined in Idfen.h and _ contain the following 
information: 


LDFILE *ldptr; 


TYPE(Idptr) The file magic number, used to 
distinguish between archive members 
and simple object files. 


OPTR(Idptr) The file pointer returned by fopen and 
used by the standard input/output 
functions. 

OFFSET(Idptr) The file address of the beginning of the 
object file; the offset is non-zero if the 
object file is a member of an archive 


file. 


HEADER(Idptr) The file header structure of the object 
file. 


The object file access functions themselves may be 
divided into four categories: 


(1) functions that open or close an object file 
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ldopen(3X) and Idaopen 

open a common object file 
Idelose(3X) and Idaclose 

close a common object file 


(2) functions that read header or symbol table 
information 


Idahread(3X) 
read the archive header of a member of 
an archive file 

Idfhread(3X) 


ie the file header of a common object 


ldehread( 3X and ldnshread 
read a section header of a common 
object file 

Idtbread(3X) 
read a symbol table entry of a common 
object file 

ldgethame(3X) 
retrieve a symbol name from a symbol 
table entry or from the string table 


(3) functions that position an object file at (seek to) the 
start of the section, relocation, or line number 
information for a particular section. 


Idohseek(3X) 
seek to the optional file header of a 
common object file 
Idsseek(3X) and Idnsseek 
seek to a section of a common object file 
ldrseek(3X) and Idnraeek 
seek to the relocation information for a 
section of a common object file 
Idlseek(3X) and Idnlseek 
seek to the line number information for 
a section of a common object file 
Idtbseek(3X) 
seek to the symbol table of a common 
object file 


(4) the function /dtbindez(3X) which returns the index of 
a particular common object file symbol table entry. 


These functions are described in detail on their 
respective manual pages. 


All the functions except Ildopen oxy Idgetname(3X), 
Idaopen (8X), and ldtbindez return Aire 
SUCCESS or FAILURE, both ae defined in 
Idfen.h. Ldopen and Idaopen both return pointers to a 
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LDFILE structure. 


Additional access to an object file is provided through a 
set of macros defined in Idfen.h. These macros parallel 
the standard input/output file reading and manipulating 
functions, translating a reference of the LDFILE 
structure into a reference to its file descriptor field. 


The following macros are provided: 


Cede) 

FGETO(Idptr) 

GETW(ldptr) 

UNGETC(c, Idptr 

FGETS(s, n, ldptr 
FREAD((char *) ptr, sizeof (*ptr), nitems, ldptr) 
FSEEK(ldptr, offset, otfnaniey 
FTELL(idptr) 
REWIND(ldptr) 

FEOF(ldptr 

FERROR(ldptr) 
FILENO(Idptr) 
SETBUF(ldptr, buf 
STROFFSET(Idptr 


The STROFFSET macro calculates the address of the 
string table in an object file. See the manual entries for 
the corresponding standard input/output library 
functions for details on the use of the rest of the macros. 


The program must be loaded with the object file access 
routine library libld.a. 


WARNING 
The macro FSEEK defined in the header file Idfen.h 
translates into a call to the standard input/output 
function fseek(3S). FSEEK should not be used to seek 
from the end of an archive file since the end of an 
archive file may not be the same as the end of one of its 
object file members! 


SEE ALSO 
fseek(3S), Idahread(3X), Idclose(3X), ldgetname(3X), 
ldfhread(3X), Ildlread(3X), Idlseek(3X), Idohseek(3X 
Idopen(3X),  Idrseek(3X), Idlseek(3X),  Idshread(3X 
ldtbindex(3X), ldtbread(3X), ldtbseek(3X). 


’ 


’ 
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NAME 

linenum — line number entries in a common object file 
SYNOPSIS 

#include <linenum.h> 
DESCRIPTION 


Compilers based on pee generate an entry in the object 
file for each C source line on which a breakpoint is 
possible (when invoked with the —g option; see ¢c(1)). 
Users can then reference line numbers when using the 
appropriate software test system (see ah The 
structure of these line number entries appears below. 


struct lineno 
union 


long l_symndx ; 
long l|_paddr ; 
l_addr ; 
} unsigned short |]_Inno ; 
Numbering starts with one for each function. The initial 
line number entry for a function has |_Inno equal to zero, 
and the symbol table index of the function’s entry is in 
l_symndz. Otherwise, {_Inno is non-zero, and l_paddr is 
the physical address of the code for the referenced line. 
Thus the overall structure is the following: 


l_addr lInno 
function symtab index 0 
physical address line 


physical address line 


function symtab index 0 
physical address line 
physical address line 


SEE ALSO 
ec(1), sdb(1), a.out(4). 
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NAME 
master — master device information table 


DESCRIPTION 

This file is used by the config(1M) program to obtain 
device information that enables it to generate the 
configuration files. Do not modify it unless you fully 
understand its construction. The file consists of 3 parts, 
each separated by a line with a dollar sign ($) in column 
1. Part 1 contains device information; part 2 contains 
names of devices that have aliases; part 3 contains 
tunable parameter information. Any line with an 
asterisk (*) in column 1 is treated as a comment. 


Part 1 contains lines consisting of 7 or 10 fields, with the 
fields delimited by tabs and/or blanks: 


Field 1: device name (8 chars. maximum). 
Field 2: device mask (octal)-each ‘‘on” bit 
indicates that the handler exists: 
001000 has release handler for 
downloadable drivers 
000200 tty header exists 
000100 initialization handler 
000040 power-failure handler 
000020 open handler 
000010 close handler 
000004 read handler 
000002 write handler 
000001 ioctl handler. 
Field 3: device type indicator (octal): 
001000 cluster device 
000400 VME device 
000200 allow only one of these devices 
000040 suppress interrupt vector 
000020 required device 
000010 block device 
000004 character device 
000002 floating vector 
000001 fixed vector. 


Field 4: handler prefix (4 chars. maximum). 

Field 5: major device number for  block-type 
device. 

Field 6: major device number for character-type 
device. 

Field 7: maximum number of devices on system. 

Field 8: device vector size. 

Field 9: device address type fo modifier). 

Field 10: device interrupt level. 
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Part 2 contains lines with 2 fields each: 

Field 1: alias name of device (8 chars. maximum). 

Field 2: reference name of device (8 chars. 
maximum; specified in part 1). 

Part 3 contains lines with 2 or 3 fields each: 


Field 1: parameter name (as it appears in 
description file; 20 chars. maximum) 

Field 2: parameter name (as it appears in the 
conf.c file; 20 chars. maximum) 

Field 3: default parameter value in chars. 
maximum; parameter specification is 


required if this field is omitted) 
FILES 
/etc/master 
SEE ALSO 
config(1M). 
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NAME 

mnttab — mounted file system table 
SYNOPSIS 

#include <mnttab.h> 
DESCRIPTION 


Mnttab resides in directory /ete and contains a table of 
devices, mounted by the mount(1M) command, in the 
following structure as defined by <mnttab.h>: 


struct mnttab { 


char mt_dev(32]; 
char mt_filsys[32]; 
short mt_ro_flg; 
time_t mt_time; 


}; 
Each entry is 70 bytes in length; the first 32 bytes are 
the null-padded name of the place where the special file 
is mounted; the next 32 bytes represent the null-padded 
root name of the mounted special file; the remaining 6 
bytes contain the mounted spectal file’s read/write 
permissions and the date on which it was mounted. 


The maximum number of entries in mnttab is based on 
the system parameter NMOUNT located in 
/usr/sre/uts/cf/conf.c, which defines the number of 
allowable mounted special files. 


SEE ALSO 
mount(1M), setmnt(1M). 
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NAME 


networks — names and numbers for the internet 


DESCRIPTION 


The file /ete/networks lists networks on the internet. 
Each line describes a single network and consists of the 
following blank separated fields: 


name number altases ... 


where 
name 
number 
aliases... 
EXAMPLE 


is the official name of the network. 
All nodes on the internet should use 
the same official name for a given 
network. 


is the network number, which 
serves as part of the DARPA 
Internet address for each node on 
the internet. All nodes on the 
internet must use the same number 
for a given network. 


is a blank-separated list of local 
aliases for the network. 


The routines which search this file 
ignore comments (portions of lines 
beginning with #) and blank lines. 


# Building 1 Internet 
Engineering 1 #R&D 
Production 2 #Administration, etc. 


SEE ALSO 
hosts(4N). 


CTIX Internetworking Manual. 


FILES 
/etc /networks 


NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NAME 


PASSWD ( 4) 


passwd — password file 


DESCRIPTION 


Passwd contains for each user the following information: 


login name 

encrypted password 
numerical user ID 
numerical group ID 

user name 

initial working directory 
program to use as Shell 


This is an ASCII file. Each field within each user’s entry 
is separated from the next by a colon. Each user is 
separated from the next by a new-line. If the password 
field is null, no password is demanded; if the Shell field 
is null, /bin/sh is used. 


This file resides in directory /ete. Because of the 
encrypted passwords, it can and does have general read 
permission and can be used, for example, to map 
numerical user IDs to names. 


The encrypted password consists of 13 characters chosen 
from a 64-character alphabet (., /, 0-9, A—Z, a-z), 
except when the password is null, in which case the 
encrypted password is also null. Password aging is 
effected for a particular user if his encrypted password in 
the password file is followed by a comma and a non-null 
string of characters from the above alphabet. (Such a 
string must be introduced in the first instance by the 
super-user.) 


The first character of the age, M say, denotes the 
maximum number of weeks for which a password is 
valid. A user who attempts to login after his password 
has expired will be forced to supply a new one. The next 
character, m say, denotes the minimum period in weeks 
which must expire before the password may be changed. 
The remaining characters define the week (counted from 
the beginning of 1970) when the password was last 
changed. (A null string is equivalent to zero.) M and m 
have numerical values in the range 0-63 that correspond 
to the 64-character alphabet shown above (i.e, / = 1 
week; 5 = 63 weeks). If m = M = 0 (derived from the 
string . or ..) the user will be forced to change his 
password the next time he logs in (and the “age” will 
disappear from his entry in the password file). If m > 
M (signified, e.g., by the string ./) only the super-user 
will be able to change the password. 


a 
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FILES 
/etc/passwd 


SEE ALSO 


1641(3C), login(1), ey a641(3C), 


getpwent(3C), group(4 


crypt(3C), 


NAME 


PLOT (4) 


plot — graphics interface 


DESCRIPTION 


Files of this format are produced by routines described in 
plot(3X) and are interpreted for various devices by 
commands described in tplot(1G). A graphics file is a 
stream of plotting instructions. Each instruction consists 
of an ASCII letter usually followed by bytes of binary 
information. The instructions are executed in order. A 
point is designated by four bytes representing the x and 
y values; each value is a signed integer. The last 
designated point in an 1, m, n, or p instruction becomes 
the “current point’’ for the next instruction. 


Each of the following descriptions begins with the name 
of the corresponding routine in plot(3X). 


m move: The next four bytes give a new current point. 


n cont: Draw a line from the current point to the point 
given by the next four bytes. See tplot(1G). 


p point: Plot the point given by the next four bytes. 


1 line: Draw a line from the point given by the next 
four bytes to the point given by the following four 
bytes. 


t label: Place the following ASCII string so that its 
first character falls on the current point. The string 
is terminated by a new-line. 


e erase: Start another frame of output. 


f linemod: Take the following string, up to a new-line, 
as the style for drawing further lines. The styles are 
‘“‘dotted’’, ‘“‘solid”, “longdashed”’, ‘‘shortdashed”’, and 
‘“‘dotdashed”. Effective only for the —T4014 and 
-Tver options of tplot(1G) (TEKTRONIX 4014 
terminal and Versatec plotter). 


s space: The next four bytes give the lower left corner 
of the plotting area; the following four give the upper 
right corner. The plot will be magnified or reduced 
to fit the device as closely as possible. 


Space settings that exactly fill the plotting area with 
unity scaling appear below for devices supported by the 
filters of tplot(1G). The upper limit is just outside the 
plotting area. In every case the plotting area is taken to 
be square; points outside may be displayable on devices 
whose face is not square. 


DASI 300 space(0, 0, 4096, 4096); 
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DASI 300s space(0, 0, 4096, 4096); 
DASI 450 space(0, 0, 4096, 4096); 
TEKTRONIX 4014  space(0, 0, 3120, 3120); 
Versatec plotter space(0, 0, 2048, 2048}: 


SEE ALSO 
graph(1G), tplot(1G), plot(3X), gps(4), term(5). 
WARNING 
The plotting library plot(3X) and the curses library 
curses(3X) both use the names erase() and move(). The 
curses versions are macros. If you need both libraries, 
put the plot(3X) code in a different source file than the 
curses(3X) code, and/or #undef move() and erase() in 
the plot(3X) code. 


NAME 


PROFILE (4) 


profile — setting up an environment at login time 


DESCRIPTION 


FILES 


If the file /ete/profile exists, it will be executed for 
every Bourne shell user immediately upon login. After 
this, if the user’s login directory contains a file named 
-profile, that file will be be executed (via . .profile) 
before the user’s session begins. The .profile is useful 
for exporting environment variables and terminal modes. 


The following example is typical for a user’s .profile file: 


PATH=:$PATH:$HOME/bin 
MAIL=/usr/mail/myname 
TERM=pt 

export PATH MAIL TERM 
umask 022 


The system file /etc/profile can be customized to set 
the TERM environment variable via tset(1) and to 
automatically invoke wm(1) on RS-422 terminals. 


Shell environment variables that can be set are described 
in sh(1). 


$HOME/.profile 
/etc/profile 


SEE ALSO 


esh(1), cprofile(4), env(1), login(1), mail(1), sh(1), stty(1), 
au) 'tset(1), wm(1), ), ttytype( 4), environ(5), term(5). 
MightyFrame Administrator’ s Reference + ae) 
MintFrame Admintstrator’s Manual. 


NAME 


PROTOCOLS (4N) 


protocols — list of Internet protocols 


DESCRIPTION 


FILES 


The file /ete/protocols lists known DARPA Internet 
protocols. Each line describes a single protocol and 
consists of the following blank separated fields: 


name number aliases ... 
where 
name is the official name of the protocol. 
number is the protocol number. 


aliases... is a blank-separated list of local aliases for 
the protocol. 


The routines which search this file ignore comments 
(portions of lines beginning with #) and blank lines. 


Protocol names and numbers are specified by the SRI 
Network Information Center. Do not change this file 
unless you are familiar with DARPA Internet internals. 


/ete/protocols 


SEE ALSO 


NOTE 
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This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 

reloc ~ relocation information for a common object file 
SYNOPSIS 

#include <reloc.h> 
DESCRIPTION 

Object files have one relocation entry for each 


relocatable reference in the text or data. If relocation 
information is present, it will be in the following format. 


struct reloc 


long r_vaddr ; 

/* (virtual) address of reference */ 
long r_symndx ; 

/* index into symbol table */ 
short r_type ; /* relocation type */ 


* 
* All generics 
* reloc. already performed to symbol in the same section 


* 
#define R_ABS 0 


* 
*Motorola Processors 68000, 68010, and 68020 
* 


* 
* 


#define R_DIR24 04 
#define R_REL24 05 
#define RLOPT16 014 
#define R_IND24 015 
#define R_IND32 016 


#define RLRELBYTE 017 
#define RLRELWORD 020 
#define RLRELLONG 021 
#define RLPCRBYTE 022 
#define RLPCRWORD 023 
#define RLPCRLONG 024 


As the link editor reads each input section and performs 
relocation, the relocation entries are read. They direct 
how references found within the input section are 
treated. 
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R_ABS The reference is absolute, and no relocation 
is necessary. The entry will be ignored. 


R_DIR24 A direct, 24-bit reference to a symbol’s 
virtual address. 


R_REL24 A ‘“PC-relative’’, 24-bit reference to a 
symbol’s virtual —_ address. Relative 
references occur in instructions such as 
jumps and calls. The actual address used 
is obtained by adding a constant to the 
value of the program counter at the time 
the instruction is executed. 


R_OPT16 An optimized, indirect, 16-bit reference 
through a transfer vector. The instruction 
contains the offset into the transfer vector 
table to the transfer vector where the 
actual address of the referenced word is 
stored. 


R_IND24 An indirect, 24-bit reference through a 
transfer vector. The instruction contains 
the virtual address of the transfer vector, 
where the actual address of the referenced 
word is stored. 

R_IND32 An indirect, 32-bit reference through a 
transfer vector. The instruction contains 
the virtual address of the transfer vector, 
where the actual address of the referenced 
word is stored. 

R_RELBYTE A direct 8-bit reference to a symbol’s 
virtual address. 

R_RELWORD 
A direct 16-bit reference to a symbol’s 
virtual address. 


R_RELLONG A direct 32-bit reference to a symbol’s 
virtual address. 


R_PCRBYTE A ‘“PC-relative’’, 8-bit reference to a 
symbol’s virtual address. 


R_PCRWORD 
A “PC-relative’, 16-bit reference to a 
symbol’s virtual address. 
R_PCRLONG A “PC-relative”, 32-bit reference to a 
symbol’s virtual address. 
On the VAX processors relocation of a symbol index of -1 
indicates that the relative difference between the current 
segment’s start address and the program’s load address is 
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added to the relocatable address. 


Other relocation types will be defined as they are 
needed. 


Relocation entries are generated automatically by the 
assembler and automatically utilized by the link editor. 
A link editor option exists for removing the relocation 
entries from an object file. 


SEE ALSO 
ld(1), strip(1), a.out(4), syms(4). 
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NAME 
rhosts — remote equivalent users 

DESCRIPTION 
These files grant permission for remote users to use local 
user names without knowing the corresponding user 
passwords. This is known as making the remote user 
“equivalent” to the local user. This is convenient, for 
example, when one person owns user names on more 
than one node. 
If a user’s home directory contains a file named .rhosts, 
remote users specified in the file are equivalent to the 
local user. Each user specification in the file consists of 
the remote user node name and user name, separated by 
a space. For security reasons, .rhosts must belong to 
the user granting the equivalence or to root. 
The file /etc/hosts.equiv is a list of remote nodes with 
matching-name equivalence. The file lists remote nodes 
one per line. On each node listed in /etc/hosts.equiv, 
a remote user with the same name as a local user is 
equivalent to the local user. In effect, the users are the 
same if the names are the same. 

FILES 
$HOME/.rhosts 
/etc/hosts.equiv 

SEE ALSO 
remd(1N), rep(1N), rlogin(1N). 
CTIX Internetworking Manual. 

WARNINGS 
When a system is listed in /etc/hosts.equiv, its 
security must be as good as local security. 

NOTE 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 


NAME 
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sccsfile — format of SCCS file 


DESCRIPTION 


An SCCS file is an ASCII file. It consists of six logical 
parts: the checkaum, the delta table contains 
information about each delta), user names eae 
login names and/or numerical group IDs of users who 
may add deltas), flags (contains definitions of internal 
keywords), comments (contains arbitrary descriptive 
information about the file), and the body (contains the 
actual text lines intermixed with control lines). 


Throughout an SCCS file there are lines which begin with 
the ASCII SOH (start of heading) character (octal 001). 
This character is hereafter referred to as the control 
character and will be represented graphically as @. 
Any line described below which is not depicted as 
beginning with the control character is prevented from 
beginning with the control character. 


Entries of the form DDDDD represent a five-digit string 
(a number between 00000 and 99999). 


Each logical part of an SCCS file is described in detail 
below. 


Checksum 
The checksum is the first line of an SCCS file. 
The form of the line is: 
@hDDDDD 


The value of the checksum is the sum of all 
characters, except those of the first line. The 
@h provides a magic number of (octal) 064001. 


Delta table 
The delta table consists of a variable number of 
entries of the form: 


@s DDDDD/DDDDD/DDDDD 

Q@d <type> <SCCSID> yr/mo/da hr:mi:se 
<pgmr> DDDDD DDDDD 

@i DDDDD ... 

@x DDDDD ... 

@g DDDDD ... 

@m <MR number> 


@c <comments> ... 
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@e 


The first line (@s) contains the number of lines 
append) dela unchanged; respectively. The 
second line (@d) contains the type of the delta 
(currently, normal: D, and removed: R), the 
SCCS ID of the delta, the date and time of 
creation of the delta, the login name 
corresponding to the real user ID at the time the 
delta was created, and the serial numbers of the 
delta and its predecessor, respectively. 


The @i, @x, and @g lines contain the serial 
numbers of deltas included, excluded, and 
ignored, respectively. These lines are optional. 


The @m lines (optional) each contain one MR 
number associated with the delta; the @c lines 
contain comments associated with the delta. 


The @e line ends the delta table entry. 


User names 


Flags 


The list of login names and/or numerical group 
IDs of users who may add deltas to the file, 
separated by new-lines. The lines containing 
these login names and/or numerical group IDs 
are surrounded by the bracketing lines @u and 
@U. An empty list allows anyone to make a 
delta. Any line starting with a ! prohibits the 
succeeding group or user from making deltas. 


Keywords used internally (see admtn(1) for more 
information on their use). Each flag line takes 
the form: 


@f <flag> <optional text > 


The following flags are defined: 


@f t <type of program > 
@fv <program name> 
@f i <keyword string > 
@f b 

@fm <module name> 
@ff <floor> 

@f c <ceiling > 

@fd <default-sid> 

@f n 
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Of j 

@f | <lock-releases > 

@fq <user defined> 

@f z <reserved for use in interfaces > 


The t flag defines the replacement for the %Y% 
identification keyword. The v flag controls prompting 
for MR numbers in addition to comments; if the optional 
text is present it defines an MR number validity 
checking program. The i flag controls the warning/error 
aspect of the “No id keywords’? message. When the i 
flag is not present, this message is only a warning; when 
the i flag is present, this message will cause a ‘fatal’ 
error (the file will not be gotten, or the delta will not be 
made). When the b flag is present the —b keyletter may 
be used on the get command to cause a branch in the 
delta tree. The m flag defines the first choice for the 
replacement text of the %M% identification keyword. 
The f flag defines the “floor” release; the release below 
which no deltas may be added. The c flag defines the 
“ceiling” release; the release above which no deltas may 
be added. The d flag defines the default SID to be used 
when none is specified on a get command. The n flag 
causes delta to insert a “null” delta (a delta that applies 
no changes) in those releases that are skipped when a 
delta is made in a new release (e.g., when delta 5.1 is 
made after delta 2.7, releases 3 and 4 are skipped). The 
absence of the n flag causes skipped releases to be 
completely empty. The j flag causes get to allow 
concurrent edits of the same base SID. The | flag defines 
a list of releases that are locked against editing (get(1) 
with the -e keyletter), The q flag defines the 
replacement for the %Q% identification keyword. The 
s flag is used in certain specialized interface programs. 


Comments 
Arbitrary text is surrounded by the bracketing 
lines @t and @T. The comments section 
typically will contain a description of the file’s 
purpose. 


Body 
The body consists of text lines and control lines. 
Text lines do not begin with the control 
character, control lines do. There are three 
kinds of control lines: insert, delete, and end, 
represented by: 


@I DDDDD 
@D DDDDD 
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@E DDDDD 


respectively. The digit string is the serial 
number corresponding to the delta for the 
control line. 


SEE ALSO 
admin(1), delta(1 get(), prs(1). 
CTIX Py ae) 8 Guide, Section 9. 


SCNHDR (4) 


NAME 
scnhdr — section header for a common object file 


SYNOPSIS 
#finclude <scenhdr.h> 


DESCRIPTION 
Every common object file has a table of section headers 
to specify the layout of the data within the file. Each 
section within an object file has its own header. The C 
structure appears below. 


struct scnhdr 


{ 
char s_name|SYMNMLEN]; /* section name */ 
long s_paddr; /* physical address */ 
Jong s.vaddr;  /* virtual address */ 
long s_size; /* section size */ 
long s.scnptr; /* file ptr to raw data */ 
long s_relptr; /* file ptr to relocation */ 
long s_Innoptr; /* file ptr to line numbers */ 
unsigned short s_nreloc; /* # reloc entries */ 
unsigned short s_ninno; /* # line number entries */ 
long s_flags; /* flags */ 

}; 


File pointers are byte offsets into the file; they can be 
used as the offset in a call to fseek(3S). If a section is 
initialized, the file contains the actual bytes. An 
uninitialized section is somewhat different. It has a size, 
symbols defined in it, and symbols that refer to it. But 
it can have no relocation entries, line numbers, or data. 
Consequently, an uninitialized section has no raw data in 
the object file, and the values for s_senptr, s_relptr, 
s_innoptr, s_nreloc, and s_ninno are zero. 


SEE ALSO 
Id(1), fseek(3S), a.out(4). 


— 


NAME 


SERVICES (4N) 


services — list of Internet services 


DESCRIPTION 


FILES 


The file i etc/services lists known DARPA Internet 
services. Each line describes a single service and consists 
of the following blank separated fields: 


name number / protocol aliases ... 


where 
name is the official name of the service. 
number is the service number. 
protocol is the name of the protocol (see 
protocols(4N)) used by the service. 
aliases... is a blank-separated list of local 


aliases for the service. 


The routines which search this file ignore comments 
(portions of lines beginning with #) and blank lines. 


Service names and numbers are specified by the SRI 
Network Information Center. Do not change this file 
unless you are familiar with DARPA Internet internals. 


/etc/services 


SEE ALSO 


NOTE 


CTIX Internetworking Manual. 


This command is for use with a special version of the 
CTIX kernel that supports networking protocols. 
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NAME 
syms — common object file symbol table format 


SYNOPSIS 
#include <syms.h> 


DESCRIPTION 
Common object files contain information to support 
symbolic software testing (see sdb) Line number 
entries, linenum(4), and extensive symbolic information 
permit testing at the C source level. Every object file’s 
symbol table is organized as shown below. 


File name 1. 
Function 1. 
Local symbols for function 1. 
Function 2. 
Local symbols for function 2. 


Static externs for file 1. 


File name 2. 
Function 1. 
Local symbols for function 1. 
Function 2. 
Local symbols for function 2. 


Static externs for file 2. 


Defined global symbols. 

Undefined global symbols. 
The entry for a symbol is a fixed-length structure. The 
members of the structure hold the name (null padded), 
its value, and other information. The C structure is 
given below. 
#define SYMNMLEN 8 
#define FILNMLEN 14 
#define DIMNUM 4 


struct syment 
{ 


union /* all ways to get symbol name */ 


char _n_name[SYMNMLEN]; /* symbol name */ 


struct| 

{ 
long _n_zeroes; /* == OL when in string table */ 
long _h_offset; /* location of name in table */ 

} _n_n; 
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char _n_nptr(2]; /* allows overlaying */ 
} Ln; 
long _—n_value; /* value of symbol */ 
short n_scnum; /* section number */ 
unsigned short n_type; /* type and derived type */ 
char n_sclass; /* storage class */ 
char  n_numaux; /* number of aux entries */ 
hs 
#define n_name  _n._n_name 
#define n_zeroes _n._n_n._n_zeroes 
#define n_offset _n._n_n._n_offset 
#define n_nptr —n._n_nptr[1] 


Meaningful values and explanations for them are given in 
both syms.h and Common Object File Format. Anyone 
who needs to interpret the entries should seek more 
information in these sources. Some symbols require more 
information than a single entry; they are followed by 
auziliary entries that are the same size as a symbol 
entry. The format follows. 


union auxent 


struct 
long x_tagndx; 
union 
struct 
unsigned shortx_Inno; 
unsigned shortx_size; 
} x_Insz; 
ong x_fsize; 
} x_misce; 
union 
struct 
long x_Innoptr; 
long x_endndx; 
} x_fen; 
struct 
unsigned shortx_dimen[DIMNUM}]; 
} x_ary; 
x_fcnary; 
unsigned short x_tvndx; 
} x_sym; 
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struct 
char x_fname[FILNMLEN}; 
} x_file; 
struct 
long x_scenlen; 
unsigned short x_nreloc; 
unsigned short x_nlinno; 
} X_scn; 
struct 
long x_tvfill; 
unsigned short x_tvlen; 
unsigned short x_tvran(2]; 
} x_tv; 


}; 
Indexes of symbol table entries begin at zero. 


SEE ALSO 
sdb(1), a.out(4), linenum(4). 


CAVEATS 
CTIX C longs are equivalent to ints and are converted to 
ints in the compiler to minimize the complexity of the 
compiler code generator. Thus the information about 
which symbols are declared as longs and which, as ints, 
does not show up in the symbol table. 


NAME 


SYSTEM (4) 


system — system description file 


DESCRIPTION 


The system description describes tunable variables and 
hardware configuration to the CTIX system. 


The file is formatted in sections. Each section begins 
with a section header (a ! followed by a single word). 
Each section varies in format, depending upon the 
format required by the program that uses the data 
provided by that section. 


In the example file the }VWMESLOTS section describes 
the VME boards for the EEPROM. The slot field is the 
slot position in the VME bus. The type field is the board 
type; board types may be: 


1 CMC Ethernet board 
2 Interphase SMD disk controller board 
3 Xylogics 1/2-inch tape controller board 


The address field is the location of the board. The 
length field is the address space size of the board. The 
optional initialization function name is an initialization 
function that is called by the PROM at boot time. 


The !VMECODE section consists of a list of files that 
describe the executable code to be loaded into the 
EEPROM. This section is required only if a bootable 
initialization function was specified. 


EXAMPLE 
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{FILENAMES 
PROM_IFILE=/etc/Iddrv/EEPROM..ifile 
EEPROM_FILE=/dev/vme/eeprom 
INIT_CFILE=tunevar.c 

IVMESLOTS 

The following section describes the VME boards 


*slot type address length Hnitalaeten 
* unction name | 
* 
0 2 C1000000 512 init Vs32 
1 2 C1000200 512 
*one CMC Ethernet controller) 
2 1 CODE0200 131072 
* 
I'VMECODE 
diskvs32.0 
Pan ee 
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SEE ALSO 
\ddrv(1M), ldeeprom(1M), mktunedrv(1M), oe ee 
MightyFrame Administrator's Reference Manual. 


FILES — 
/ete/system 
/dev/vme/eeprom 
— 
— 
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NAME 


TERM (4) 


term — format of compiled term file. 


SYNOPSIS 


term 


DESCRIPTION 


5/86 


Compiled terminfo descriptions are placed under the 
directory /usr/lib/terminfo. In order to avoid a linear 
search of a huge CTIX system directory a two-level 
scheme is used: /usr/lib/terminfo/c/name where 
name is the name of the terminal, and c is the first 
character of name. Thus, act4 can be found in the file 
/usr/lib/terminfo/a/act4. Synonyms for the same 
terminal are implemented by multiple links to the same 
compiled file. 


The format has been chosen so that it will be the same 
on all hardware. An 8 or more bit byte is assumed, but 
no assumptions about byte ordering or sign extension are 
made. 


The compiled file is created with the tic(1M) program, 
and read by the routine setupterm. Both of these pieces 
of software are part of curses(3X). The file is divided 
into six parts: the header, terminal names, boolean flags, 
numbers, strings, and string table. 


The header section begins the file. This section contains 
six short integers in the format described below. These 
integers are (1) the magic number (octal 0432); (2) the 
size, in bytes, of the names section; (3) the number of 
bytes in the boolean section; (4) the number of short 
integers in the numbers section; (5) the number of offsets 
(short integers) in the strings section; (6) the size, in 
bytes, of the string table. 


Short integers are stored in two 8-bit bytes. The first 
byte contains the least significant 8 bits of the value, 
and the second byte contains the most significant 8 bits. 
(Thus, the value represented is 256*second-+first.) The 
value —1 is represented by 0377, 0377; other negative 
values are illegal. The -—1 generally means that a 
capability is missing from this terminal. Note that this 
format corresponds to the hardware of the VAX and 
PDP-11. Machines where this does not correspond to the 
hardware read the integers as two bytes and compute the 
result. 


The terminal names section comes next. It contains the 
first line of the terminfo description, listing the various 
names for the terminal, separated by the ‘|’ character. 
The section is terminated with an ASCII NUL character. 


a 
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The boolean flags have one byte for each flag. This byte 
is either 0 or 1 as the flag is present or absent. The 
capabilities are in the same order as the file <term.h>. 


Between the boolean section and the number section, a 
null byte will be inserted, if necessary, to ensure that the 
number section begins on an even byte. All short 
integers are aligned on a short word boundary. 


The numbers section is similar to the flags section. Each 
capability takes up two bytes, and is stored as a short 
integer. If the value represented is —1, the capability is 
taken to be missing. 


The strings section is also similar. Each capability is 
stored as a short integer, in the format above. A value 
of -1 means the capability is missing. Otherwise, the 
value is taken as an offset from the beginning of the 
string table. Special characters in “X or \c notation are 
stored in their interpreted form, not the printing 
representation. Padding information $<nn> _ and 
parameter information %x are stored intact in 
uninterpreted form. 


The final section is the string table. It contains all the 
values of string capabilities referenced in the string 
section. Each string is null terminated. 


Note that it is possible for setupterm to expect a 
different set of capabilities than are actually present in 
the file. Either the database may have been updated 
since setupterm has been recompiled (resulting in extra 
unrecognized entries in the file) or the program may 
have been recompiled more recently than the database 
was updated (resulting in missing entries). The routine 
setupterm must be prepared for both possibilities — this 
is why the numbers and sizes are included. Also, new 
capabilities must always be added at the end of the lists 
of boolean, number, and string capabilities. 


As an example, an octal dump of the description for the 
Microterm ACT 4 is included: 


microterm|act4|microterm act iv, 
cr="M, cud1="J, ind=*J, bel=*G, am, cubl=‘H, 
ed=*_, el=**, clear=‘L, cup==“T%p1%c%p2%c, 
cols#80, lines#24, cufl=“X, cuul=*Z, home=‘], 


FILES 
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000032001 +=\0025 \0 \b \0212 \0 "\O0 micr 

Be ee MR eal Te 

040 t e rm a t i v \O \0001 \o \0 

060 \0 \O \O \o \o \o \o \o \O \o \o \o \o \o \o \o 

100 \O \O P \0 377 377 030 \0 377 377 377 377 377 377 377 377 
120 377 377 377 377 \O \0 002 \0 377 377 377 377 004 \0 006 \O 
140 \b \0 377 377 377 377 \n \0026 \0 030 \0 377 377 032 \O 
160 377 377 377 377 034 \O 377 377 036 \0 377 377 377 377 377 377 
200 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 
* 

520 377 377 377 377 \O 377 377 377 377 377 377 377 377 377 377 
540 377 377 377 377 377 377 007 \O0 \r \O \f \0 036 \0 037 \0 
560024 % p 1% ¢ % p 2 % ¢ \O \n \0035 \O 
600 \b \0 030 \0032 \0 \n \O 


Some limitations: total compiled entries cannot exceed 
4096 bytes. The name field cannot exceed 128 bytes. 


/usr/lib/terminfo/*/* compiled terminal capability 
data base 


SEE ALSO 


curses(3X), terminfo(4). 


TERMCAP (4) 


NAME 

termcap — terminal capability data base 
SYNOPSIS 

/etc/termcap 
DESCRIPTION 


This entry describes terminal-independent programming 
conventions that originate at UC Berkeley. UNIX System 
V initially borrowed termcap but has since changed to 
the termtnfo(4) convention. CTIX continues to support 
termcap so as to be compatible with the Berkeley version 
of the UNIX System. But use terminfo in new programs. 


Termcap programs work from information supplied 
through the TERM and TERMCAP environment 
variables. The location of the description depends on 
the value of TERMCAP: 


e If TERMCAP is not set or is empty, TERM 
is the name of an description in /ete/termcap. 
° If TERMCAP has a value that begins with a /, 


TERM is the name of an description in the file 
named by TERMCAP. 


° If TERMCAP begins with any character 
except /, TERMCAP contains the description. 


A description begins with a list of its names, separated 
by vertical bars. The rest of the description is a list of 
capabilities, separated by colons. If you use more than 
one line, precede each newline except the last with :\ 
Here’s a simple example. 


abieeboldee vt50: 
bs:c oe J: enna aes co#80:1i#12:\ 
nd= \EC:pt:up=\E. 


There are three kinds of es 


° Boolean. These indicate the presence or absence 
of a terminal feature by their presence or 
absence. Boolean capabilities consist of two 
characters (the capability name). 


° Numerte. These indicate some numeric value 
for the terminal, such as screen size or delay 
required by a standard character. Numeric 
capabilities consist of two characters (the 
capability name), followed by a #, followed by a 
decimal number. 


° String. These indicate a sequence that is 
performs some operation on the terminal. String 


Lect 
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capabilities consist of two characters Ka 
capability name), optionally followed by a delay, 
followed by a string. 


The delay is the number of milliseconds the 
program must wait after using the sequence; 
specify no more than one decimal place. If the 
delay is proportional to the number of lines 
affected, end it with a *. 


The string is a sequence of characters. The 
following subsequences are specially interpreted. 


\E Escape Character 
z  Control-z 
\n Newline 


\r Return 
t Tab 
Backspace 
f Formfeed 


\zzz Octal value of zzz 
\072 _: in string 
\200 null (\000 doesn’t work) 


Octal numbers must be three digits long. 


Some strings are interpreted further, such as em. 
see something below. 


You can follow any capability name with an @, to 
indicate that the terminal lacks the capability. This is 
only useful in conjunction with the te capability; see 
‘“‘Similar Terminals,’ below. 


Here is a list of standard capabilities. (P) indicates a 
string that might require padding; (P*) indicates a string 
that might require proportional padding. 


Name Type Pad? Description 


ae str P) Ends alternate character set. 

al str P*) Adds new blank line. 

am bool Terminal has automatic margins. 

as str (P) Starts alternate character set. 

be str Backspace if not control-h. 

bs bool Terminal can backspace with 
control-h. 

bt str (P) Back tab. 

bw bool Backspace wraps from column 0 
to last column. 

CC str Command character in prototype 


if terminal settable. 


str 
str 
str 


str 
str 


num 
str 
str 
str 


bool 
num 


bool 
num 


str 
num 


str 
str 
num 
str 
num 
str 
str 
str 
str 


bool 
str 


str 


str 
str 


str 
str 


bool 
bool 
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P*) 
>} 


fp) 


P*) 
P 


P) 


(P*) 


(P*) 


(P*) 


(P) 


Clears to end of display. 
Clears to end of line. 
Moves cursor horizontally to 
specified column. 
Clears screen. 
Moves cursor to specified row and 
column. 
Number of columns in a line. 
Carriage return if not control-m. 
Change scrolling region. - 
Moves cursor. vertically to 
specified row. 
Display can be retained above. 
Delay after backspace, in 
milliseconds. 
Display can be retained below. 
Delay after carriage return, in 
milliseconds. 
Delete character. 
Delay after form feed, in 
milliseconds. 
Deletes line. 
Enters delete mode. 
Delay after newline, in 
milliseconds. 
Goes down one line. 
Delay after tab, in milliseconds. 
Ends delete mode. 
Ends insert mode; give an empty 
string if you’ve defined ic. 
Can erase overstrikes with a 
blank. 
Hardcopy terminal page eject if 
not form feed. 
Hardcopy terminal. 
Half-line down (forward 1/2 
linefeed). 
Move cursor to upper left corner 
home). 

alf-line up (reverse 1/2 linefeed). 
Hazeltine or other terminal that 
can’t print ~’s. 
Insert character. 
Name of file containing terminal 
initialization. 
Starts insert mode; give an empty 
string if you’ve defined ic. 
Insert mode distinguishes nulls on 
display. 
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(P*) Pad after insertion. 


Terminal initialization. 

Sent by special (usually numeric) 
function keys. If programmable, 
set with is, if, vs, or ti. 

Sent by backspace key. 

Sent by terminal down arrow key. 
Ends keypad transmit mode. 

Sent by home key. 

Sent by terminal left arrow key. 
Number of special function keys. 
Terminal capabilities that have 
keys. 

Sent by terminal right arrow key. 
Begin keypad transmit mode. 
Sent by terminal up arrow key. 
Labels on special function keys. 
Number of lines on screen or 
page. 

Last line, first column. 

Command key map; used by ex 
version 2 (Convergent uses 
version 3). 

Safe to move while in_ insert 
mode. 

Memory lock on above cursor. 
Safe to move while in standout 
and underline mode. 

Memory unlock (turn off memory 
lock). 

No correctly working carriage 
return (DM2500,H2000). 
Non-destructive space (cursor 
right). 

Begin a new line if not newline. 

A video terminal that doesn’t 
scroll! 

Terminal overstrikes. 

Pad character if not null. 

Has hardware tabs; if they need 
to be set put sequence in is or if. 
Ends stand out mode. 

Scrolls forwards. 

Number of blank chars left by so 
or se. 

Begins stand out mode. 

Scroll reverse (backwards). 

Tab if not control-i or with 
padding. 
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str Name of terminal that has some 
of the same capabilities; te must 
be the last capability. 


str Ends programs that do cursor 
motion. 

str Initializes programs that do 
cursor motion. 

str Underscores and moves past one 
character. 

str Ends underscore mode. 

num Number of blank spaces that 
surround underscore mode. 

bool Terminal underlines 


automatically even though it 
can’t overstrike 


str Upline (cursor up). 

str Start underscore mode. 

str Visible bell (must not move 
cursor). 

str Ends open and visual modes. 

str Initializes open and visual modes. 

bool Beehive (fl—escape, f2=ctrl ie 

bool Terminal ignores newline after 
wrap (Concept). 

bool Return clears to end of line and 
oes to beginning of next line 
Delta Data). 

bool Writing on standout mode text 
produces standout mode text (HP 
2647). 

bool Destructive tabs, magic standout 


character (Teleray 1061). 


Pointers on Preparing Descriptions 


You may want to copy the description of a 
similar terminal. 


Build up a description gradually, checking 
partial descriptions with ez. 


Be aware that an unusual terminal may expose 
bugs in ez. limitations in the termcap 
convention. 


Basic Capabilities 


The 


following capabilities are common to most 


terminals. The co capability gives the number of 
columns per line. The li gives the number of lines on a 
video terminal. The am capability indicates that 
writing off the right edge takes the cursor to the 
beginning of the next screen. The cl capability tells how 
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the terminal clears its screen. The bs indicates that the 
terminal can backspace; but if the terminal doesn’t use 
control-h, specify be instead of bs. The os capability 
indicates that printing a character at an occupied 
position doesn’t destroy the existing character. 


A couple of notes on moving off the edge. Programs 
that use this convention never move the cursor off the 
top or the left edge of the screen. On the other hand, 
they assume that moving off the bottom edge scrolls the 
display up. 

These capabilities suffice to describe hardcopy and very 
dumb terminals. For example, the Teletype Model 33 
has this description. 


t3 | 33 | tty33:co##72:0s 


This is LSI ADM8 (without the cursor addressing 
option). 
cl | adm3|3|lsi adm3:am:bs:cl=*Z:li##24:cof##80 
Cursor Addresses and Other Variables 

If a string capability includes a variable value, use a % 
escape to indicate the value. By default, programs take 
these values to be zero origin (that is, the first possible 
value is 0) and that the em capability specifies two 


values: row, then column. Use the %r or %i capability 
if either assumption is incorrect. 


These are the valid % escapes. 


%d print the values as a decimal number 

%2 print the values as a two-digit decimal number 

%3 print the values as a three-digit decimal number 

%. print the value in binary (but see below) 

%+2z add ASCII value of z to value, then print in 
binary 


%>e2xy if the next value is greater than the ASCII value 
of xz, add the ASCII value of y before using the 
value’s % escape 


Yor row is the first value in this em 

%i values are 1-origin 

%%  printa % 

%n in this capability, exclusive or the values with 
01400 before using the values’ % escapes 
(DM2500 


%B change the next value to binary coded decimal 
((16*(2/10)) + (z%10) where z is the value) 
before interpreting it 


TERMCAP (4) 


%D The next value is reverse-coded (2-2*(2%16) 
where z is the value; Delta Data) 


A program should avoid using a em sequence that 

—_ includes a tab, newline, control-d, or return, because the 
terminal interface may misinterpret these characters. If 
possible, use the em sequence to move to the row or 
column after the destination, then use local motion to 
get to the destination. 


Here are some examples of em definitions. To position 
the cursor of an HP2645 on row 3, column 12, you must 
send the terminal ‘“\E&al2c03Y”, followed by a 6 
millisecond delay; the HP2645 description includes 
:eom=6\EX&%r%2ce%2Y:. To position the cursor of 
an ACT-IV, you send it a control-t, followed by the row 
and column in binary; the ACT-IV description includes 
som=="T%.%.: The LSI ADM8a uses the set of 
printable ASCII characters to represent row and column 
values; its description includes :em\E=%+%+:. 


Local and General Cursor Motions 
Most terminals have short strings that trigger 
commonly-used cursor motions. A non-destructive space 
(BR nd ) moves the cursor one position right. An upline 
—_— sequence (up) moves the cursor one position up. A home 
sequence (ho) moves the cursor to the upper left hand 
corner. A lower-left (ll) goes to the other lefthand 
corner. The ll capability may be a sequence that moves 
the cursor home, then up; but otherwise programs never 
do this. 


Area Clears 

Some terminals have short sequences that clear all or 
part of a display. Clear (cl ) clears the screen and homes 
the cursor; if clearing the screen does not restore the 
terminal’s normal modes, cl should include the strings 
that do. Clear to end of line (ce ) clears from the 
current cursor position to the right. Clear to end of 
display (ed ) clears from the current cursor position to 
the bottom of the display; programs always move the 
cursor to the beginning of the line before using ed. 


Insert/Delete Line 

any terminals have strings that shift text starting at 

the current cursor position. Programs always move the 

~ cursor to the beginning of the line before using these 
strings. Add line (al) shifts the current line and all 

below it down a position leaving the cursor on the 
newly-blanked line. Delete line (deletes the line the 

cursor is on without moving the cursor. If a terminal 

description has a al capability, you do not really need to 
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specify sb. 


If deleting a line might produce a non-blank line at the 
bottom of the screen, specify db. If scrolling backwards 
might produce a non-blank line at the top of the screen, 
specify da. 


Insert /Delete Character 


he termcap convention recognizes two kinds of terminal 


insert /delete string. 


The first convention is by far more common. 
Using insert or delete modes only affect 
characters on the current line. Inserting a single 
character shifts all characters, including all 
blanks, to the right; the character on the right 
edge of the screen is lost. No special capability 
is required to describe this kind of terminal. 


The second convention is rarer and more 
complicated. The terminal distinguishes 
between blank spaces created by output tabs 
(011) or spaces (040) from all other blanks; other 
blanks are known as nulls. Inserting a character 
eliminates the first null to the right of the 
cursor; deleting a character doubles the first 
null. If there are no nulls on the current line 
inserting a character inserts the line’s rightmost 
character at the beginning of the next line. Use 
the in capability to describe this kind of 
terminal. 


Notably among the second type are the Concept 100 and 
Perkin Elmer Owl. 


A simple experiment shows what type you have. Set the 
terminal to its “local”? mode. Clear the screen, then 
type a short sequence of text. Move the cursor to the 
right several spaces without ustng the space or tab 
characters. Type a second short sequence of text. Move 
the cursor back to the beginning of the first text. Start 
the terminal’s insert mode and begin tapping the space 


bar. 


If you have the first kind of terminal, both 


sequences of text will move at once, at whatever 
character is at the right edge of the screen will be lost. 
If you have the second kind of terminal, at first only the 
first sequence of text will move; when the first sequence 
hits the second sequence, it will push the second onto the 
next line. 


A terminal can have either an insert mode or the ability 
to insert a single character. Specify insert mode with im 
and ei. To specify that the terminal can insert a single 
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character, specify ic and specify empty strings for im 
and ei. If you must delay or output more control text 
after inserting a single character, specify ip. 


If a terminal has both an insert mode and the ability to 
insert a single character, it is usually best not to specify 
ic. 


Some programs operate more quickly if they are allowed 
to move the cursor around randomly while in insert 
mode. For example, vt has to delete a character when 
you insert a character before a tab. If your terminal 
permits this, specify move on insert mi. Beware of 
terminals that foul up in subtle ways when you do this 
notably Datamedia’s. 


Delete mode (dm), end delete mode (ed), and delete 
character (de) work like im, ei, and ic. 


Highlighting, Underlining, and Visible Bells 
Specify the terminals most distinctive display mode with 
so se. Half intensity is usually not a good choice unless 
the terminal is normally in reverse video. 


The convention provides for underline mode and for 
single character underlining. Specify underline mode 
with us and ue. Specify a way to underline and move 
past a character with uc; if your terminal can underline 
a single character but doesn’t automatically move on, 
add a nondestructive space to the uc string. 


Some terminals can’t overstrike but still correctly 
underline text without special help from the host 
computer. If yours is one, specify ul. 


If your terminal spaces before and after entering 
standout and underline mode, specify ug. 


Programs leave standout and underline mode _ before 
moving the cursor or printing a newline. 


If the terminal can flash the screen without moving the 
cursor, specify vb (visual bell). 


If the terminal needs to change working modes before 
entering the open and visual modes of ez and v1, specify 
vs and ve. respectively. These can be used to change, 
e.g., from a underline to a block cursor and back. 


If the terminal needs to be in a special mode when 
running a program that addresses the cursor, specify ti 
and te. This may be important if a terminal has more 
than one page of memory. If the terminal has memory- 
relative cursor addressing but not screen relative cursor 
addressing, use ti to fix a screen-sized window into the 
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terminal. 


If a terminal can overstrike, programs assume that 
printable spaces don’t destroy anything, unless you 
specify eo. 
Keypad 

Some terminals have keypads that transmit special 
codes. If the keypad can be turned on and off, specify 
ks and ke; if you don’t, programs assume that the 
keypad is always on. Specify the codes sent by cursor 
motion keys with kl, kr, ku, kd, and kh. If there are 
function keys specify the codes they send with fl, f2, f3, 
f4, f5, 6, f7, f8, and f9. If these keys have labels other 
than the usual ‘“‘fO0 through” “‘f9’’, specify the labels 11, 
12, 18, 14, 15, 16, 17, 18, and 19. If there are other keys 
that transmit the same code that the terminal expects 
for a function, such as clear screen, mention the affected 
capabilities in the ko capability. For example, 
‘“ko=cl,ll,sf,sb:” says that the terminal has clear, home 
down, scroll down, and scroll up keys that transmit the 
same thing as the cl, ll, sf, and sb capabilities. 


Terminal Initialization 

If a terminal must be initialized, on login for example, 
specify a short string with is or a file containing 
initialization strings with if. Other capabilities include 
is, an initialization string for the terminal, and if, the 
name of a file containing long initialization strings. If 
both are given, is is printed before if. If the terminal 
has tab stops, these strings should first clear all stops, 
then set new stops at the 9 column and every 8 columns 
thereafter. 


Similar Terminals 

If a new terminal strongly resembles an _ existing 
terminal, you can write a description of the new terminal 
that only mentions the old terminal and the capabilities 
that differ. The te capability describes the old terminal; 
it must be the last capability in the description. If the 
old terminal has capabilities that the new one lacks, 
specify an @ after the capability name. 


The different entries you create with te need not 
represent terminals that are actually different. They can 
represent different uses for a single terminal, or user 
preferences as to which terminal features are desirable. 
The following example defines a describes a variant of 
the 2621 that never turns on the keypad. 


hn | 2621n):ks@:ke@:tc=2621: 
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FILES 
/etc/termcap standard data base 

SEE ALSO 
ex(1), more(1), tset(1), ul(1), vi(1), curses(3), termcap(3), 
terminfo(4). 

BUGS 


£z allows only 256 characters for string capabilities, and 
the routines in termcap(3) do not check for overflow of 
this buffer. 


The total length of a single description (excluding only 
escaped newlines) may not exceed 1024 characters. If 
you use te, the combined description may not exceed 
1024 characters. 


The vs, and ve entries are specific to the vt program. 


Not all programs support all entries. There are entries 
that are not supported by any program. 


The ma capability is obsolete and serves no function in 
our database; Berkeley includes it for the benefit of 
systems that cannot run version 3 of v1. 
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terminfo — terminal capability data base 


SYNOPSIS 


/usr/lib/terminfo/* /* 


DESCRIPTION 


Terminfo is a data base describing terminals, used, e.g.,, 
by vi(1) and curses(3X). Terminals are described in 
terminfo by giving a set of capabilities which they have, 
and by describing how operations are performed. 
Padding requirements and initialization sequences are 
included in terminfo. 


Entries in terminfo consist of a number of ‘,’ separated 
fields. White space after each ‘,’ is ignored. The first 
entry for each terminal gives the names which are known 
for the terminal, separated by ‘|’ characters. The first 
name given is the most common abbreviation for the 
terminal, the last name given should be a long name 
fully identifying the terminal, and all others are 
understood as synonyms for the terminal name. All 
names but the last should be in lower case and contain 
no blanks; the last name may well contain upper case 
and blanks for readability. 


Terminal names (except for the last, verbose entry) 
should be chosen using the following conventions. The 
particular piece of hardware making up the terminal 
should have a root name chosen, thus “hp2621”’. This 
name should not contain hyphens, except that synonyms 
may be chosen that do not conflict with other names. 
Modes that the hardware can be in, or user preferences, 
should be indicated by appending a hyphen and an 
indicator of the mode. Thus, a vt100 in 132 column 
mode would be vtl00—w. The following suffixes should 
be used where possible: 


Suffix Meaning Example 
-w Wide mode (more than 80 columns) vt100-w 
-am With auto. margins (usually default) vt100-am 
-nam Without automatic margins vti00-nam 
-n Number of lines on the screen aaa— 60 
-na No arrow keys (leave them in local) c100—na 
-np Number of pages of memory c100-—4p 
“TV Reverse video c100-rv 
CAPABILITIES 


The variable is the name by which the programmer (at 
the terminfo level) accesses the capability. The capname 
is the short name used in the text of the database, and is 
used by a person updating the database. The i.code is 
the two letter internal code used in the compiled 
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database, and always corresponds to the old termcap 
capability name. 


Capability names have no hard length limit, but an 
informal limit of 5 characters has been adopted to keep 
them short and to allow the tabs in the source file caps 
to line up nicely. Whenever possible, names are chosen 
to be the same as or similar to the ANSI X3.64-1979 
standard. Semantics are also intended to match those of 
the specification. 


(P) indicates that padding may be specified 


indicates that the string is passed through tparm 


with parameters as given (#1). 


(*) indicates that padding may be based on the 
number of lines affected 


indicates the i 


(#)) parameter. 
Variable Cap- I. Description 
Booleans name Code 
auto_left_margin, bw bw cubl wraps from column 0 to last 
column 
auto_right_margin, am am Terminal has automatic margins 
beehive_glitch, xsb xb Beehive (fl=escape, [2=ctrl C) 
ceol_standout_glitch, xhp xs Standout not erased by overwriting 
(hp) 
eat_newline_glitch, xenl xn newline ignored after 80 cols 
(Concept) 
erase_overstrike, eo eo Can erase overstrikes with a blank 
generic_type, gn gn Generic line type (e.g.,, dialup, 
switch). 
hard_copy, he he Hardcopy terminal 
has_function_line hfi hf Terminal has a function key label 
line 
has_meta_key, km km Has a meta key (shift, sets parity 
bit) 
has_status_line, hs hs Has extra “status line” 
insert_null_glitch, in in Insert mode distinguishes nulls 
memory_above, da da Display may be retained above the 
screen 
memory_below, db db Display may be retained below the 
screen 
move_insert_mode, mir mi Safe to move while in insert mode 
move_standout_mode, msgr ms Safe to move in standout modes 
over_strike, os os Terminal overstrikes 
status_line_esc_ok, eslok es Escape can be used on the status 
line 
5 if 86 -2- 


teleray_glitch, 


tilde_glitch, 
transparent_underline, 
xon_xoff, 


Numbers: 
columns, 
init_tabs, 
line_attribute 
lines, 
lines_of_memory, 


magic_cookie_glitch, 
padding_baud_rate, 
virtual_terminal, 
width_status_line, 


Strings: 
back_tab, 
bell, 
carriage_return, 
change_scroll_region, 


clear_all_tabs, 
clear_screen, 

clr_eol, 

elr_eos, 
column_address, 
command_character, 


cursor_address, 


cursor_down, 
cursor_home, 
cursor_invisible, 
cursor_left, 
cursor_mem_address, 
cursor_normal, 


cursor_right, 
cursor_to_ll, 
cursor_up, 
cursor_visible, 
delete_character, 
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xt xt Tabs ruin, magic so char (Teleray 
1061) 

hz hz Hazeltine; can not print ~’s 

ul ul underline character overstrikes 

xon xo Terminal uses xon/xoff handshaking 

cols co Number of columns in a line 

it it Tabs initially every # spaces 

Idaat LA Line drawing character attribute 

lines li Number of lines on screen or page 

Im Im Lines of memory if > lines. 0 means 
varies 

xme_ — 8g Number of blank chars left by smso 
or rmso 

pb pb Lowest baud where cr/nl padding is 
needed 

vt vt Virtual terminal number (UNIX 
system) 

ws] ws No. columns in status line 


ebt bt Back tab (P) 
bel bl Audible signal (bell) (P) 


cr cr Carriage return (P*) 

esr cs change to lines #1 through #2 
(vt100) (PG) 

tbe et Clear all tab stops (P)} 

clear cl Clear screen and home cursor (P*) 

el ce Clear to end of line (P) 

ed ed Clear to end of display (P*) 

hpa_ —s ch Set cursor column (PG) 

emdch CC Term. settable cmd char in 
prototype 

cup cm Screen rel. cursor motion row #1 col 
#2 (PG) 

cudil do Down one line 

home ho Home cursor (if no cup) 

civis vi Make cursor invisible 

cubl le Move cursor left one space 

mreup CM Memory relative cursor addressing 

cnorm ve Make cursor appear normal (undo 
ys/vi) 

cufl ad Non-destructive space (cursor right) 

Nl N Last line, first column (if no cup) 

cuul sup Upline (cursor up) 

evvis vs Make cursor very visible 


dchl “de Delete character (P*) 
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delete_line, dil dl Delete line (P*) 
dis_status_line, dsl ds Disable status line 
down_half_line, hd hd Half-line down (forward 1/2 
linefeed) 
enter_alt_charset_mode, smacs as Start alternate character set (P) 
enter_blink_mode, blink mb Turn on blinking 
enter_bold_mode, bold md Turn on bold (extra bright) mode 
enter_ca_mode, smeup ti String to begin programs that use 
cup 
expand center; lw(1.4i) lw(.4i) Iw(.4i) 
1w(1.8i). 
enter_delete_mode, smdc dm Delete mode (enter) 
enter_dim_mode, dim mh Turn on half-bright mode 
enter_insert_mode, smir im Insert. mode (enter); 
enter_protected_mode, prot mp Turn on protected mode 
enter_reverse_mode, rev mr Turn on reverse video mode 
enter_secure_mode, invis mk Turn on blank mode (chars 
invisible) 
enter_standout_mode, smso_ so Begin stand out mode 
enter_underline_mode, smul us Start underscore mode 
erase_chars ech ec Erase #1 characters (PG) 
exit_alt_charset_mode, rmacs ae End alternate character set (P) 
exit_attribute_mode, sgrO = me Turn off all attributes 
exit_ca_mode, rmeup te String to end programs that use cup 
exit_delete_mode, rmdc_ ed End delete mode 
exit_insert_mode, rmir (ei! End insert mode 
exit_standout_mode, rmso se End stand out mode 
exit_underline_mode, rmul ue End underscore mode 
flash_screen, flash vb Visible bell (may not move cursor) 
form_feed, ff ff Hardcopy terminal page eject (P*) 
from_status_line, fs] fs Return from status line 
init_Istring, isl il Terminal initialization string 
init_2string, is2 i2 Terminal initialization string 
init_3string, is3 i3 Terminal initialization string 
init_file, if if Name of file containing is 
insert_character, ichl (ie ° Insert character (P) 
insert_line, ill ‘al Add new blank line (P*) 
insert_padding, ip ip Insert pad after character inserted (p*) 
key_backspace, kbs kb Sent by backspace key 
key_catab, ktbe = ka Sent by clear-ali-tabs key 
key_clear, kelr kc Sent by clear screen or erase key 
key_ctab, ketab kt Sent by clear-tab key 
key_de, kdchl kD Sent by delete character key 
key_dl, kdl kL Sent by delete line key 
key_down, keudl ka Sent by terminal down arrow key 
key_eic, krmir kM Sent by rmir or smir in insert mode 
key_eol, kel kE Sent by clear-to-end-of-line key 
key_eos, ked kS Sent by clear-to-end-of-screen key 
key_fo, kfo ko Sent by function key f0 
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key_f1, kfl k1 Sent by function key fl 

key_f10, kfl0 ska Sent by function key f10 

key_f2, kf2 k2 Sent by function key f2 

key_f3, kf3 k3 Sent by function key f3 

key_f4, kf4 k4 Sent by function key [4 

key_f5, kf5 k5 Sent by function key [5 

key_f6, kf6 k6 Sent by function key f6 

key_f7, kf7 k7 Sent by function key [7 

key_f8, kfg k8 Sent by function key [8 

key_f9, kfe k9 Sent by function key [9 

key_home, khome We Sent by home key 

key_ic, kich1 I Sent by ins char/enter ins mode key 

key_il, kill kA Sent by insert line 

key_left, keubl_ kl Sent by terminal left arrow key 

key_ll, kil kH Sent by home-down key 

key_npage, knp kN Sent by next-page key 

key_ppage, kpp kP Sent by previous-page key 

key_right, keufl kr Sent by terminal right arrow key, 

key_sf, kind kF Sent by scroll-forward/down key 

key_sr, kri kR Sent by scroll-backward/up key 

key_stab, khts kT Sent by set-tab key 

key_up, keuul ku Sent by terminal up arrow key 

keypad_local, rmkx ke Out of "keypad transmit” mode 

keypad_xmit, smkx ks Put terminal in “keypad transmit” 
mode 

lab_fo, 1f0 10 Labels on function key f0 if not f0 

lab_f1, ift IL Labels on function key fl if not f1 

lab_f10, 1f10 la Labels on function key [10 if not f10 

lab_f2, If2 12 Labels on function key f2 if not [2 

lab_f3, 1f3 13 Labels on function key [3 if not [3 

lab_f4, if4 14 Labels on function key [4 if not f4 

lab_f5, 1f 15 Labels on function key f5 if not f5 

lab_f6, 1f6 16 Labels on function key [6 if not f6 

lab_f{7, 1f7 17 Labels on function key f7 if not [7 

lab_fs, 1f8 18 Labels on function key f8 if not [8 

lab_f9, Ifa 19 Labels on function key f9 if not [9 

Id_upleft Idul TL Upper left corner box character 

\d_upright idur ss TR Upper right corner box character 

Id_botleft Idgl BL Bottom left corner box character 

Id_botright Idbfy BR Bottom right corner box character 

Id_vertleft Idv} VL Left-hand side box character 

Id_vertright Idvr VR Right-hand side box character 

Id_hortop Idht TH Top side box character 

Id_horbot Idhb BH Bottom horizontal box character 

Id_upleft \dul TL Upper left corner box character 

Id_upleft Idul TL Upper left corner box character 

Id_upleft Idul TL Upper left corner box character v 

meta_on, smm mm _ Turnon “meta mode” (8th bit) 

meta_off, tmm mo Turn off “meta mode” 


newline, 
pad_char, 
parm_dch, 


parm_delete_line, 
parm_down_cursor, 


parm_ich, 
parm_index, 


parm_insert_line, 
parm_left_cursor, 
parm_right_cursor, 


parm_rindex, 


parm_up_cursor, 


pkey_key, 
pkey_local, 
pkey_xmit, 
print_screen, 
prtr_off, 
prtr_on, 
repeat_char, 
reset_Istring, 


reset_2string, 
reset_3string, 


reset_file, 
restore_cursor, 
row_address, 
save_cursor, 
scroll_forward, 
scroll_reverse, 
set_attributes, 
set_tab, 
set_window, 


tab, 
to_status_line, 
underline_char, 
up_half_line, 
init_prog, 
key_al, 
key_a3, 
key_b2, 
key_cl, 
key_c3, 
prtr_non, 
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nel 
pad 
dch 
dl 
cud 
ich 
indn 
il 
cub 
cuf 
rin 
cuu 
pfkey 
pfloc 
pfx 
mcO 
mc4 
mcd 
rep 
rsl 


rs2 
rs3 


rf 

re 
vpa 
sc 
ind 
ri 
sgr 
hts 
wind 


ht 

tsl 

uc 

hu 
iprog 
kal 
ka3 
kb2 
kel 
kc3 
mcdp 


Newline (behaves like cr followed by If) 
Pad character (rather than null) 

Delete #1 chars (PG*) 

Delete #1 lines (PG*) 

Move cursor down #1 lines (PG*) 
Insert #1 blank chars (PG*) 

Scroll forward #1 lines (PG) 

Add #1 new blank lines (PG*) 

Move cursor left #1 spaces (PG) 

Move cursor right #1 spaces (PG*) 
Scroll backward #1 lines (PG) 

Move cursor up #1 lines (PG*) 

Prog funct key #1 to type string #2 
Prog funct key #1 to execute string #2 
Prog funct key #1 to xmit string #2 
Print contents of the screen 

Turn off the printer 

Turn on the printer 

Repeat char #1 #2 times. (PG*) 
Reset terminal completely to sane 
modes. 

Reset terminal completely to sane 
modes. 

Reset terminal completely to sane 
modes. 

Name of file containing reset string 
Restore cursor to position of last sc 
Vertical position absolute set row) (PG) 
Save cursor position (P) 

Scroll text up (P) 

Scroll text down (P) 

Define the video attributes (PG9) 

Set a tab in all rows, current column 
Current window is lines #1-#2 

cols #3-#4 

Tab to next 8 space hardware tab stop 
Go to status line, column #1 
Underscore one char and move past it 
Half-line up (reverse 1/2 linefeed) 

Path name of program for init 

Upper left of keypad 

Upper right of keypad 

Center of keypad 

Lower left of keypad 

Lower right of keypad 

Turn on the printer for #1 bytes 
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A Sample Entry 
The following entry, which describes the Concept—100, is 
among the more complex entries in the terminfo file as of 
this writing. 


concept100 | c100| concept | c104 | c100-4p | concept 100, 

am, bel==“G, blank==\EH, blink=\EC, clear=*L$<2*>, cnorm=\Ew, 
cols#80, cr-="M$<9>, cubl=‘H, cudl=‘J, cufl=\E=, 

cup=\Ea%p1%’ '%+%c%p2%’ °%+%e, 

cuul=\E;, evvis=\EW, db, dchl=\E*A$<16*>, dim=\EE, dli=\E‘BS<3*>, 
ed=\E’C$<16*>, el=\EU$<16>, eo, flash=\Ek$<20>\EK, ht=\t$<8>, 
il1=\E’*R$<3*>, in, ind=*J, .ind=*J$<9>, ip=$<16*>, 
is2=\EU\Ef\E7\E5\E8\El\ENH\EK\E\200\Eo&\200\Eo\47\E, 

kbs="h, keubl=\E>, kcudl=\E<, kcufl=\E=, kcuul=\E;, 

kfl=\E5, kf2=\E6, kf3=\E7, khome=\E?, 

lines#24, mir, pb¥#9600, prot=\EI, rep=\Er%p1%c%p2%’ '%+%c$<.2*>, 
rev=\ED, rmcup=\Ev $<6>\Ep\r\n, rmir=\E\200, rmkx=\Ex, 
rmso=\Ed\Ee, rmul=\Eg, rmul=\Eg, sgrO=\EN\ 200, 
smcup=\EU\Ev 8p\Ep\r, smir=\E’P, smkx=\EX, smso=\EE\ED, 
smul=\EG, tabs, ul, vt#8, xenl, 


Entries may continue onto multiple lines by placing 
white space at the beginning of each line except the first. 
Comments may be included on lines beginning with 
‘““#t’?, Capabilities in terminfo are of three types: 
Boolean capabilities which indicate that the terminal has 
some particular feature, numeric capabilities giving the 
size of the terminal or the size of particular delays, and 
string capabilities, which give a sequence which can be 
used to perform particular terminal operations. 


Types of Capabilities 

All capabilities have names. For instance, the fact that 
the Concept has automatic margins (i.e., an automatic 
return and linefeed when the end of a line is reached) is 
indicated by the capability am. Hence the description of 
the Concept includes am. Numeric capabilities are 
followed by the character ‘#’ and then the value. Thus 
cols, which indicates the number of columns the 
terminal has, gives the value ‘80’ for the Concept. 


Finally, string valued capabilities, such as el (clear to 
end of line sequence) are given by the two-character 
code, an ‘=’, and then a string ending at the next 
following ‘,’. A delay in milliseconds may appear 
anywhere in such a capability, enclosed in $<..> 
brackets, as in el=\EK$<3>, and padding characters 
are supplied by tputs to provide this delay. The delay 
can be either a number, e.g., ‘20’, or a number followed 
by an ‘*’, ie., ‘3*. A ‘*? indicates that the padding 
required is proportional to the number of lines affected 
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by the operation, and the amount given is the per- 
affected-unit padding required. (In the case of insert 
character, the factor is still the number of lines affected. 
This is always one unless the terminal has xenl and the 
software uses it.) When a ‘*’ is specified, it is sometimes 
useful to give a delay of the form ‘3.5’ to specify a delay 
per unit to tenths of milliseconds. (Only one decimal 
place is allowed.) 


A number of escape sequences are provided in the string 
valued capabilities for easy encoding of characters there. 
Both \E and \e map to an ESCAPE character, “x maps 
to a control-x for any appropriate x, and the sequences 
\n \I \r \t \b Nd \s give a newline, linefeed, return, 
tab, backspace, formfeed, and space. Other escapes 
include \* for *, \\ for \, \, for comma, \: for :, and \0 
for null. (\0 will produce \200, which does not terminate 
a string but behaves as a null character on most 
terminals.) Finally, characters may be given as three 
octal digits after a X: 


Sometimes individual capabilities must be commented 
out. To do this, put a period before the capability 
name. For example, see the second ind in the example 
above. 


Preparing Descriptions 

We now outline how to prepare descriptions of terminals. 
The most effective way to prepare a terminal description 
is by imitating the description of a similar terminal in 
terminfo and to build up a description gradually, using 
partial descriptions with vt to check that they are 
correct. Be aware that a very unusual terminal may 
expose deficiencies in the ability of the terminfo file to 
describe it or bugs in vt. To easily test a new terminal 
description you can set the environment variable 
TERMINFO to a pathname of a directory containing the 
compiled description you are working on and programs 
will look there rather than in /usr/ltb/terminfo. To get 
the padding for insert line right (if the terminal 
manufacturer did not document it) a severe test is to 
edit /etc/passwd at 9600 baud, delete 16 or so lines from 
the middle of the screen, then hit the ‘u’ key several 
times quickly. If the terminal messes up, more padding 
is usually needed. A similar test can be used for insert 
character. 


Basic Capabilities 
The number of columns on each line for the terminal is 


given by the cols numeric capability. If the terminal is 
a CRT, then the number of lines on the screen is given 
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by the lines capability. If the terminal wraps around to 
the beginning of the next line when it reaches the right 
margin, then it should have the am capability. If the 
terminal can clear its screen, leaving the cursor in the 
home position, then this is given by the clear string 
capability. If the terminal overstrikes (rather than 
clearing a position when a character is struck over) then 
it should have the os capability. If the terminal is a 
printing terminal, with no soft copy unit, give it both he 
and os. (os applies to storage scope terminals, such as 
TEKTRONIX 4010 series, as well as hard copy and APL 
terminals.) If there is a code to move the cursor to the 
left edge of the current row, give this as er. (Normally 
this will be carriage return, control M.) If there is a code 
to produce an audible signal (bell, beep, etc) give this as 
bel. 


If there is a code to move the cursor one position to the 
left (such as backspace) that capability should be given 
as cubl. Similarly, codes to move to the right, up, and 
down should be given as cuf1, cuul, and cudl. These 
local cursor motions should not alter the text they pass 
over, for example, you would not normally use ‘cuf1l= ’ 
because the space would erase the character moved over. 


A very important point here is that the local cursor 
motions encoded in terminfo are undefined at the left 
and top edges of a CRT terminal. Programs should 
never attempt to backspace around the left edge, unless 
bw is given, and never attempt to go up locally off the 
top. In order to scroll text up, a program will go to the 
bottom left corner of the screen and send the ind (index) 
string. 


To scroll text down, a program goes to the top left 
corner of the screen and sends the ri (reverse index) 
string. The strings ind and ri are undefined when not 
on their respective corners of the screen. 


Parameterized versions of the scrolling sequences are 
indn and rin which have the same semantics as ind and 
ri except that they take one parameter, and scroll that 
many lines. They are also undefined except at the 
appropriate edge of the screen. 


The am capability tells whether the cursor sticks at the 
right edge of the screen when text is output, but this 
does not necessarily apply to a cufl from the last 
column. The only local motion which is defined from 
the left edge is if bw is given, then a cubl1 from the left 
edge will move to the right edge of the previous row. If 
bw is not given, the effect is undefined. This is useful 
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for drawing a box around the edge of the screen, for 
example. If the terminal has switch selectable automatic 
margins, the terminfo file usually assumes that this is on; 
i.e., am. If the terminal has a command which moves to 
the first column of the next line, that command can be 
given as nel (newline). It does not matter if the 
command clears the remainder of the current line, so if 
the terminal has no er and If it may still be possible to 
craft a working nel out of one or both of them. 


These capabilities suffice to describe hardcopy and 
glass-tty terminals. Thus the model 33 teletype is 
described as 


33 | tty33 | tty | model 33 teletype, 

bel=°G, cols#72, cr=“M, cudi=“J, hc, ind=“J, os, 

while the Lear Siegler ADM-3 is described as 

adm3 | 3 | lsi adm3, 

am, bel=“G, clear=*Z, cols#80, cr—=*M, cubl=‘H, cud1=“J, 
ind= “J, lines#24, 


Parameterized Strings 
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Cursor addressing and other strings requiring parameters 
in the terminal are described by a parameterized string 
capability, with printf(3S) like escapes %x in it. For 
example, to address the cursor, the cup capability is 
given, using two parameters: the row and column to 
address to. (Rows and columns are numbered from zero 
and refer to the physical screen visible to the user, not to 
any unseen memory.) If the terminal has memory 
relative cursor addressing, that can be indicated by 
mrcup. 


The parameter mechanism uses a stack and special % 
codes to manipulate it. Typically a sequence will push 
one of the parameters onto the stack and then print it in 
some format. Often more complex operations are 
necessary. 


The % encodings have the following meanings: 


%% outputs ‘%’ 

%d print pop() as in printf 
%2a print pop() like %2d 

%3d print pop() like %3d 
%02d 

%03d as in printf 

%e print pop() gives %c 

%s print pop() gives %s 
%pl[1-9 push ith parm 

ae set variable [a—z] to pop() 
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%gla-z| get variable [a—z] and push it 
%'e’ char constant c 
% {nn} integer constant nn 


%+ %- %* %/ Yom 
arithmetic (%m is mod): push(pop() 


op pop()) 
NS %\ %* bit operations: push(pop() op pop()) 
%= > %K< logical operations: push(pop() 
op pop()) 
% %~ unary operations push(op pop()) 
%i add 1 to first two parms (for ANSI 
terminals) 


%? expr %t thenpart %e elsepart %; 
if-then-else, %e elsepart is optional. 
else-if’s are possible ala Algol 68: 
%? cy Ft by %e Co %t b He Ce 
Tt br, Te cy Tt b, Te %; 


c; are conditions, ». are bodies. 


Binary operations are in postfix form with the operands 
in the usual order. That is, to get x-5 one would use 


"%ex% {5} %- 


Consider the HP2645, which, to get to row 3 and column 
12, needs to be sent \E&al2c03Y padded for 6 
milliseconds. Note that the order of the rows and 
columns is inverted here, and that the row and column 
are printed as two digits. Thus its cup capability is 
cup==6\E& %p2%2dce%p1%2dY. 


The Microterm ACT-IV needs the current row and 
column sent preceded by a “T, with the row and column 
simply encoded in binary, cup=“T%p1%c%p2%c. 
Terminals which use %c need to be able to backspace 
the cursor (cubl), and to move the cursor up one line on 
the screen (cuul). This is necessary because it is not 
always safe to transmit \n “D and \r, as the system 
may change or discard them. (The library routines 
dealing with terminfo set tty modes so that tabs are 
never expanded, so \t is safe to send. This turns out to 
be essential for the Ann Arbor 4080.) 


A final example is i LSI ADM-3a, which uses row and 
column _ offset a blank character, thus 
cup= —=\E=%p 1%" Yo 1 Beene '%+%e. After 
sending ‘\E=’, this pushes the first parameter, pushes 


the ASCII value for a space (32), adds them (pushing the 
sum on the stack in place of the two previous values) 
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and outputs that value as a character. Then the same is 
done for the second parameter. More complex arithmetic 
is possible using the stack. 


If the terminal has row or column absolute cursor 
addressing, these can be given as single parameter 
capabilities hpa (horizontal position absolute) and vpa 
(vertical position absolute). Sometimes these are shorter 
than the more general two parameter sequence (as with 
the hp2645) and can be used in preference to cup . If 
there are parameterized local motions (e.g., move n 
spaces to the right) these can be given as cud, cub, cuf, 
and cuu with a single parameter indicating how many 
spaces to move. These are primarily useful if the 
terminal does not have cup, such as the TEKTRONIX 
4025. 


Cursor Motions 

If the terminal has a fast way to home the cursor (to 
very upper left corner of screen) then this can be given 
as home; similarly a fast way of getting to the lower 
left-hand corner can be given as Il; this may involve 
going up with cuul from the home position, but a 
program should never do this itself (unless Il does) 
because it can make no assumption about the effect of 
moving up from the home position. Note that the home 
position is the same as addressing to (0,0): to the top left 
corner of the screen, not of memory. (Thus, the \EH 
sequence on HP terminals cannot be used for home.) 


Area Clears 

If the terminal can clear from the current position to the 
end of the line, leaving the cursor where it is, this should 
be given as el. If the terminal can clear from the current 
position to the end of the display, then this should be 
given as ed. Ed is only defined from the first column of 
a line. (Thus, it can be simulated by a request to delete 
a large number of lines, if a true ed is not available.) 


Insert/delete line 
If the terminal can open a new blank line before the line 
where the cursor is, this should be given as ill; this is 
done only from the first position of a line. The cursor 
must then appear on the newly blank line. If the 
terminal can delete the line which the cursor is on, then 
this should be given as dl1; this is done only from the 
first position on the line to be deleted. Versions of ill 
and dl1 which take a single parameter and insert or 
delete that many lines can be given as il and dl. If the 
terminal has a settable scrolling region (like the vt100) 
the command to set this can be described with the csr 
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capability, which takes two parameters: the top and 
bottom lines of the scrolling region. The cursor position 
is, alas, undefined after using this command. It is 
possible to get the effect of insert or delete line using this 
command - the se and re (save and restore cursor) 
commands are also useful. Inserting lines at the top or 
bottom of the screen can also be done using ri or ind on 
many terminals without a true insert/delete line, and is 
often faster even on terminals with those features. 


If the terminal has the ability to define a window as part 
of memory, which all commands affect, it should be 
given as the parameterized string wind. The four 
parameters are the starting and ending lines in memory 
and the starting and ending columns in memory, in that 
order. 


If the terminal can retain display memory above, then 
the da capability should be given; if display memory can 
be retained below, then db should be given. These 
indicate that deleting a line or scrolling may bring non- 
blank lines up from below or that scrolling back with ri 
may bring down non-blank lines. 


Insert/Delete Character 

here are two basic kinds of intelligent terminals with 
respect to insert/delete character which can be described 
using terminfo. The most common __insert/delete 
character operations affect only the characters on the 
current line and shift characters off the end of the line 
rigidly. Other terminals, such as the Concept 100 and 
the Perkin Elmer Owl, make a distinction between typed 
and untyped blanks on the screen, shifting upon an 
insert or delete only to an untyped blank on the screen 
which is either eliminated, or expanded to two untyped 
blanks. You can determine the kind of terminal you 
have by clearing the screen and then typing text 
separated by cursor motions. Type abe def using local 
cursor motions (not spaces) between the abc and the def. 
Then position the cursor before the abe and put the 
terminal in insert mode. If typing characters causes the 
rest of the line to shift rigidly and characters to fall off 
the end, then your terminal does not distinguish between 
blanks and untyped positions. If the abe shifts over to 
the def which then move together around the end of the 
current line and onto the next as you insert, you have 
the second type of terminal, and should give the 
capability in, which stands for insert null. While these 
are two logically separate attributes (one line vs. 
multiline insert mode, and special treatment of untyped 
spaces) we have seen no terminals whose insert mode 
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cannot be described with the single attribute. 


Terminfo can describe both terminals which have an 
insert mode, and terminals which send a simple sequence 
to open a blank position on the current line. Give as 
smir the sequence to get into insert mode. Give as rmir 
the sequence to leave insert mode. Now give as ichl 
any sequence needed to be sent just before sending the 
character to be inserted. Most terminals with a true 
insert mode will not give ichl; terminals which send a 
sequence to open a screen position should give it here. 
(If your terminal has both, insert mode is usually 
preferable to ich1. Do not give both unless the terminal 
actually requires both to be used in combination.) If post 
insert padding is needed, give this as a number of 
milliseconds in ip (a string option). Any other sequence 
which may need to be sent after an insert of a single 
character may also be given in ip. If your terminal 
needs both to be placed into an ‘insert mode’ and a 
special code to precede each inserted character, then 
both smir/rmir and ich1 can be given, and both will be 
used. The ich capability, with one parameter, n, will 
repeat the effects of ich1 n times. 


It is occasionally necessary to move around while in 
insert mode to delete characters on the same line (e.g., if 
there is a tab after the insertion position). If your 
terminal allows motion while in insert mode you can give 
the capability mir to speed up inserting in this case. 
Omitting mir will affect only speed. Some terminals 
(notably Datamedia’s) must not have mir because of the 
way their insert mode works. 


Finally, you can specify dechl to delete a single 
character, dch with one parameter, n, to delete n 
characters, and delete mode by giving smde and rmde 
to enter and exit delete mode (any mode the terminal 
needs to be placed in for dch1 to work). 


A command to erase n characters (equivalent to 
outputting n blanks without moving the cursor) can be 
given as ech with one parameter. 


Highlighting, Underlining, and Visible Bells 
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If your terminal has one or more kinds of display 
attributes, these can be represented in a number of 
different ways. You should choose one display form as 
standout mode, representing a good, high contrast, easy- 
on-the-eyes, format for highlighting error messages and 
other attention getters. (If you have a choice, reverse 
video plus half-bright is good, or reverse video alone.) 
The sequences to enter and exit standout mode are given 
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as smso and rmso, respectively. If the code to change 
into or out of standout mode leaves one or even two 
blank spaces on the screen, as the TVI 912 and Teleray 
1061 do, then xme should be given to tell how many 
spaces are left. 


Codes to begin underlining and end underlining can be 
given as smul and rmul respectively. If the terminal 
has a code to underline the current character and move 
the cursor one space to the right, such as the Microterm 
Mime, this can be given as uc. 


Other capabilities to enter various highlighting modes 
include blink (blinking) bold pod or extra bright) dim 
(dim or half-bright) invis (blanking or invisible text) 
prot (protected) rev (reverse video) sgrO (turn off all 
attribute modes) smacs (enter alternate character set 
mode) and rmacs (exit alternate character set mode). 
Turning on any of these modes singly may or may not 
turn off other modes. 


If there is a sequence to set arbitrary combinations of 
modes, this should be given as sgr (set attributes), 
taking 7 parameters. Each parameter is either 0 or 1, as 
the corresponding attribute is on or off. The 7 
parameters are, in order: standout, underline, reverse, 
blink, dim, bold, alternate character set. Not all modes 
need be supported by sgr, only those for which 
corresponding separate attribute commands exist. 


Terminals with the “‘magic cookie”’ glitch (xme) deposit 
special ‘cookies’? when they receive mode-setting 
sequences, which affect the display algorithm rather than 
having extra bits for each character. Some terminals, 
such as the HP 2621, automatically leave standout mode 
when they move to a new line or the cursor is addressed. 
Programs using standout mode should exit standout 
mode before moving the cursor or sending a newline, 
unless the msgr capability, asserting that it is safe to 
move in standout mode, is present. 


If the terminal has a way of flashing the screen to 
indicate an error quietly (a bell replacement) then this 
can be given as flash; it must not move the cursor. 


If the cursor needs to be made more visible than normal 
when it is not on the bottom line (to make, for example, 
a non-blinking underline into an easier to find block or 
blinking underline) give this sequence as evvis. If there 
is a way to make the cursor completely invisible, give 
that as civis. The capability cnorm should be given 
which undoes the effects of both of these modes. 
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If the terminal needs to be in a special mode when 
running a program that uses these capabilities, the codes 
to enter and exit this mode can be given as smcup and 
rmcup. This arises, for example, from terminals like 
the Concept with more than one page of memory. If the 
terminal has only memory relative cursor addressing and 
not screen relative cursor addressing, a one screen-sized 
window must be fixed into the terminal for cursor 
addressing to work properly. This is also used for the 
TEKTRONIX 4025, where smcup sets the command 
character to be the one used by terminfo. 


If your terminal correctly generates underlined characters 
(with no special codes needed) even though it does not 
overstrike, then you should give the capability ul. If 
overstrikes are erasable with a blank, then this should be 
indicated by giving eo. 


Keypad 

If the terminal has a keypad that transmits codes when 
the keys are pressed, this information can be given. Note 
that it is not possible to handle terminals where the 
keypad only works in local (this applies, for example, to 
the unshifted HP 2621 keys). If the keypad can be set to 
transmit or not transmit, give these codes as smkx and 
rmkx. Otherwise the keypad is assumed to always 
transmit. The codes sent by the left arrow, right arrow, 
up arrow, down arrow, and home keys can be given as 
keubl, keuf1, keuul, keudi, and khome respectively. 
If there are function keys such as f0, fi, ..., f10, the 
codes they send can be given as kf0, kf1, ..., kf10. If 
these keys have labels other than the default f0 through 
f10, the labels can be given as IfO, Ifl, ..., 1f10. The 
codes transmitted by certain other special keys can be 
given: kll (home down), kbs (backspace), ktbe (clear all 
tabs), ketab (clear the tab stop in this column), kelr 
(clear screen or erase key), kdch1 (delete character), 
kdl1 ee ine) krmir (exit insert mode), kel (clear to 
end of line), ked (clear to end of screen), kich1 (insert 
character or enter insert mode), kill (insert line), knp 
eet page), kpp (previous page), kind (scroll 
orward/down), kri (scroll backward/up), khts (set a 
tab stop in this column). In addition, if the keypad has 
a 3 by 3 array of keys including the four arrow keys, the 
other five keys can be given as kal, ka3, kb2, kel, and 
kc3. These keys are useful when the effects of a 3 by 3 
directional pad are needed. 


Tabs and Initialization 
If the terminal has hardware tabs, the command to 
advance to the next tab stop can be given as ht (usually 
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control I). A “‘backtab’” command which moves leftward 
to the next tab stop can be given as cbt. By convention, 
if the teletype modes indicate that tabs are being 
expanded by the computer rather than being sent to the 
terminal, programs should not use ht or cbt even if they 
are present, since the user may not have the tab stops 
properly set. If the terminal has hardware tabs which 
are initially set every n spaces when the terminal is 
powered up, the numeric parameter it is given, showing 
the number of spaces the tabs are set to. This is 
normally used by the tset command to determine 
whether to set the mode for hardware tab expansion, and 
whether to set the tab stops. If the terminal has tab 
stops that can be saved in nonvolatile memory, the 
terminfo description can assume that they are properly 
set. 


Other capabilities include is1, is2, and is3, initialization 
strings for the terminal, iprog, the path name of a 
program to be run to initialize the terminal, and if, the 
name of a file containing long initialization strings. 
These strings are expected to set the terminal into modes 
consistent with the rest of the terminfo description. 
They are normally sent to the terminal, by the tset 
program, each time the user logs in. They will be 
printed in the following order: isl; is2; setting tabs using 
tbe and hts; if; running the program iprog; and finally 
is3. Most initialization is done with is2. Special 
terminal modes can be set up without duplicating strings 
by putting the common sequences in is2 and special 
cases in isl and is3. A pair of sequences that does a 
harder reset from a totally unknown state can be 
analogously given as rsl, rs2, rf, and rs3, analogous to 
is2 and if. These strings are output by the reset 
program, which is used when the terminal gets into a 
wedged state. Commands are normally placed in rs2 
and rf only if they produce annoying effects on the 
screen and are not necessary when logging in. For 
example, the command to set the vt100 into 80-column 
mode would normally be part of is2, but it causes an 
annoying glitch of the screen and is not normally needed 
since the terminal is usually already in 80 column mode. 


If there are commands to set and clear tab stops, they 
can be given as tbe (clear all tab stops) and hts (set a 
tab stop in the current column of every row). If a more 
complex sequence is needed to set the tabs than can be 
described by this, the sequence can be placed in is2 or if. 


Certain capabilities control padding in the teletype 
driver. These are primarily needed by hard copy 
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terminals, and are used by the fset program to set 
teletype modes appropriately. Delays embedded in the 
capabilities er, ind, cubl, ff, and tab will cause the 
appropriate delay bits to be set in the teletype driver. If 
pb (padding baud rete) is given, these values can be 
ignored at baud rates below the value of pb. 


Miscellaneous 


If the terminal requires other than a null veo) character 
as a pad, then this can be given as pad. Only the first 
character of the pad string is used. 


If the terminal has an extra ‘‘status line” that is not 
normally used by software, this fact can be indicated. If 
the status line is viewed as an extra line below the 
bottom line, into which one can cursor address normally 
(such as the Heathkit h19’s 25th line, or the 24th line of 
a vtl00 which is set to a 23-line scrolling region), the 
capability hs should be given. Special strings to go to 
the beginning of the status line and to return from the 
status line can be given as tsl and fsl. (fsl must leave 
the cursor position in the same place it was before tsl. If 
necessary, the se and re strings can be included in tsl 
and fsl to get this effect.) The parameter ts] takes one 
parameter, which is the column number of the status line 
the cursor is to be moved to. If escape sequences and 
other special commands, such as tab, work while in the 
status line, the flag eslok can be given. A string which 
turns off the status line (or otherwise erases its contents) 
should be given as dsl. If the terminal has commands to 
save and restore the position of the cursor, give them as 
sc and re. The status line is normally assumed to be the 
same width as the rest of the screen, e.g., cols. If the 
status line is a different width dead because the 
terminal does not allow an entire line to be loaded) the 
width, in columns, can be indicated with the numeric 
parameter wsl. 


If the terminal can move up or down half a line, this can 
be indicated with hu (half-line up) and hd (half-line 
down). This is primarily useful for superscripts and 
subscripts on hardcopy terminals. If a hardcopy 
terminal can eject to the next page (form feed), give this 
as ff (usually control L). 


If there is a command to repeat a given character a 
given number of times (to save time transmitting a large 
number of identical characters) this can be indicated 
with the parameterized string rep. The first parameter 
is the character to be repeated and the second is the 
number of times to repeat it. Thus, tparm(repeat_char, 
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*x’, 10) is the same as ‘xxxxxxxxxx’. 


If the terminal has a settable command character, such 
as the TEKTRONIX 4025, this can be indicated with 
emdch. A prototype command character is chosen 
which is used in all capabilities. This character is given 
in the emdch capability to identify it. The following 
convention is supported on CTIX: The environment is to 
be searched for a CC variable, and if found, all 
occurrences of the prototype character are replaced with 
the character in the environment variable. 


Terminal descriptions that do not represent a specific 
kind of known terminal, such as swttch, dtalup, patch, 
and network, should include the gn (generic) capability 
so that programs can complain that they do not know 
how to talk to the terminal. (This capability does not 
apply to virtual terminal descriptions for which the 
escape sequences are known.) 


If the terminal uses xon/xoff handshaking for flow 
control, give xon. Padding information should still be 
included so that routines can make better decisions 
about costs, but actual pad characters will not be 
transmitted. 


If the terminal has a ‘“‘meta key” which acts as a shift 
key, setting the 8th bit of any character transmitted, 
this fact can be indicated with km. Otherwise, software 
will assume that the 8th bit is parity and it will usually 
be cleared. If strings exist to turn this ‘““meta mode”’ on 
and off, they can be given as smm and rmm. 


If the terminal has more lines of memory than will fit on 
the screen at once, the number of lines of memory can be 
indicated with hm. A value of Im#O0 indicates that the 
number of lines is not fixed, but that there is still more 
memory than fits on the screen. 


If the terminal is one of those supported by the UNIX 
virtual terminal protocol, the terminal number can be 
given as vt. 


Media copy strings which control an auxiliary printer 
connected to the terminal can be given as mcO: print the 
contents of the screen, mc4: turn off the printer, and 
me5: turn on the printer. When the printer is on, all 
text sent to the terminal will be sent to the printer. It is 
undefined whether the text is also displayed on the 
terminal screen when the printer is on. A _ variation 
mce5p takes one parameter, and leaves the printer on for 
as many characters as the value of the parameter, then 
turns the printer off. The parameter should not exceed 
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255. All text, including me4, is transparently passed to 
the printer while an mc5p is in effect. 


Strings to program function keys can be given as pfkey, 
pfloc, and pfx. Each of these strings takes two 
parameters: the function key number to program (from 0 
to 10) and the string to program it with. Function key 
numbers out of this range may program undefined keys 
in a terminal dependent manner. The difference between 
the capabilities is that pfkey causes pressing the given 
key to be the same as the user typing the given string; 
pfloc causes the string to be executed by the terminal in 
local; and pfx causes the string to be transmitted to the 
computer. 


If the terminal is capable of drawing solid line boxes, 
possibly by changing to a special character set, this may 
be specified. Eight single-line drawing characters may be 
given. The eight eight characters that may be specified 
represent the top left corner, top right corner, bottom 
left corner, bottom right corner left side, right side, top 
side, and bottom side of a solid line box. The four 
corner are specified with Idul, Idur, Idbl, and Idbr. 
The four sides may be specified with Idvl, Idvr, Idht, 
and Idhb. If the terminal must be in a special mode to 
draw the line characters, specify the necessary sequences 
to enter and exit the mode as one of the six highlight 
modes (alternate character set is usually a good choice); 
then give the mode number as a numeric value to Idatt. 
The correspondence of highlight modes and numeric 
values is as follows: 

underline 

reverse 

blink 

dim 

bold 

alternate character set 

standout. 


NOOR WD 


Glitches and Braindamage 


~ characters to 


Hazeltine terminals, which do not allow ‘ 
be displayed should indicate hz. 
Terminals which ignore a linefeed immediately after an 
am wrap, such as the Concept and vtl00, should 
indicate xenl. 

If el is required to get rid of standout (instead of merely 
writing normal text on top of it), xhp should be given. 
Teleray terminals, where tabs turn all characters moved 
over to blanks, should indicate xt (destructive tabs). 
This glitch is also taken to mean that it is not possible 
to position the cursor on top of a “‘magic cookie’’, that 
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to erase standout mode it is instead necessary to use 
delete and insert line. 

The Beehive Superbee, which is unable to correctly 
transmit the escape or control C characters, has xsb, 
indicating that the fl key is used for escape and f2 for 
control C. (Only certain Superbees have this problem, 
depending on the ROM.) 

Other specific terminal problems may be corrected by 
adding more capabilities of the form xz. 


Similar Terminals 


FILES 


If there are two very similar terminals, one can be 
defined as being just like the other with certain 
exceptions. The string capability use can be given with 
the name of the similar terminal. The capabilities given 
before use override those in the terminal type invoked 
by use. A capability can be cancelled by placing xx@ to 
the left of the capability definition, where xx is the 
capability. For example, the entry 
2621-nl, smkx@, rmkx@, use=2621, 

defines a 2621-nl that does not have the smkx or rmkx 
capabilities, and hence does not turn on the function key 
labels when in visual mode. This is useful for different 
modes for a terminal, or for different user preferences. 


/usr/lib/terminfo/? /* files containing terminal 
descriptions 


SEE ALSO 


tic(1M), curses(3X), printf(3S), termcap(4), term(5). 
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NAME 
ttytype — list of terminal types by terminal number 


DESCRIPTION 
Ttytype is a text file that contains, for each terminal 
configured, the terminal type as described in termcap(4). 
It is used by deet(1) when that program sets the TERM 
environment variabie. 


A line in ttytype consists of a terminal name (one of the 
abbreviations from the first field of the termcap entry), 
followed by a space, followed by the special file name of 
the terminal without the initial /dev/. 

EXAMPLES 
pt tty000 

FILES 
/ete/ttytype 

SEE ALSO 
tset(1), termcap(4). 


NAME 


TZ(4) 


TZ — time zone file 


DESCRIPTION 


FILES 


The /etc/TZ file describes the time zone for the locality 
of the CTIX system. The file contains a single entry of 
the form: 


zSTn(zDT] 


where zST is the standard three-letter abbreviation for 
the standard time zone; n is the difference in hours from 
Greenwich time; and zDT is the standard three-letter 
abbreviation for daylight saving time, if observed in the 
area. 


The earth is divided into twenty-four (0 to 23) 
longitudinal standard time zones. Adjacent time zones 
are one hour (15 degrees) apart, beginning at Greenwich 
(0 degrees), with some variations in local legal time. 


For the meridians of North America the principal time 
zones are: 


AST4ADT Atlantic Standard  Time/Daylight 
Saving Time (60 degrees) 
EST5EDT Eastern Standard Time/Daylight 


Saving Time (75 degrees) 
CST6CDT Central Standard Time/Daylight Saving 
Time (90 degrees) 


MST7MDT Mountain Standard Time/Daylight 
Saving Time (105 degrees) 


PST8PDT Pacific Standard Time/Daylight Saving 
Time (120 degrees) 
YST9YDT Yukon Standard Time/Daylight Saving 


Time (135 degrees) 


HST1OHDT Hawaiian Standard Time/Daylight 
Saving Time (150 degrees) 


NST1I1INDT Nome Standard Time/Daylight Saving 
Time (165 degrees) 


/ete/TZ 


SEE ALSO 


MightyFrame Administrator’s Reference Manual. 
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NAME 
utmp, wtmp — utmp and wtmp entry formats 


SYNOPSIS 
#include <sys/types.h> 
#include <utmp.h> 


DESCRIPTION 
These files, which hold user and accounting information 
for such commands as who(1), write(1), and login(1), 
have the following structure as defined by <utmp.h>: 


#define UTMP_FILE "/etc/utmp” 
#define WTMP_FILE "/etc/wtmp” 
#define ut_name ut_user 


struct utmp { 
char ut_user(8]; 
/* User login name */ 
char ut_id[4]; 
/* /etc/inittab id (usually line #) */ 
char ut_line[12]; 
/* device name (console, Inxx) */ 
short ut_pid; 
/* process id */ 
short ut_type; 
/* type of entry */ 
struct exit_status { 
short e_termination; 
/* Process termination status */ 
short e_exit; 
/* Process exit status #/ 
} ut_exit; 
/* The exit status of a process 
* marked as DEAD_PROCESS. */ 
time_t  ut_time; 
/* time entry was made */ 
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/* Definitions for ut_type */ 


#define 
# define 
#define 
#define 
#define 
# define 


# define 
# define 
#define 


# define 
# define 


EMPTY 0 
RUNLLVL 1 
BOOT_TIME 
OLD_TIME 
NEW_TIME 
INIT_PROCESS 


LOGIN_PROCESS 
USER_PROCESS 
DEAD_PROCESS 


ACCOUNTING 
UTMAXTYPE 


2 
3 
4 
5 
/* Process spawned by “init” */ 

6 

/* A "getty” process waiting for login */ 
7 

/* A user process */ 

8 

9 

AOQCOUNTING 

/* Largest legal value of ut_type */ 


/* Special strings or formats used in the “ut_line” field */ 
/* when accounting for something other than a process */ 
/* No string for the ut_line field can be more than 11 */ 
/* chars + a NULL in length */ 


#define 
#define 
#define 
#define 


FILES 


RUNLVL_MSG 
BOOT_MSG 
OTIME_MSG 
NTIME_MSG 


/usr/include/utmp.h 


/etc/utmp 
/etc/wtmp 


SEE ALSO 


"run—level %c” 
"system boot” 
"old time” 
"new time” 


login(1), who(1), write(1), getut(3C). 
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NAME 
intro — introduction to miscellany 
DESCRIPTION 


This section describes miscellaneous facilities such as 
macro packages, character set tables, etc. 


NAME 


DESCRIPTION 
Ascit is a map of the ASCII character set, giving both 
octal and hexadecimal equivalents of each character, to 
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FILES 
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ascii — map of ASCII character set 


SYNOPSIS 
cat /usr/pub/ascii 


be printed as needed. It contains: 


nul 001 soh 002 
bs O11 ht 012 
dle 021 del 022 
can 031 em 032 
sp 041 ! 042 
( 051 ) 052 

061 1 062 
8 071 9 072 
@ 101 A 102 
H 111 +1 112 
P 121Q~) 122 
X 181 Y 182 
S141 a 142 
h 181 i 152 
p 161 q 162 
x 17l y 172 
nul O1 soh 02 
bs 09 ht Oa 
dle 11 del 12 
can 19 em la 
8p 21! 22 
( 29 ) 2a 

311 32 
8 39 9 3a 
@ 41 A 42 
H 49 I 4a 
P 51 Q 52 
x 59 Y 5a 
b 61a 62 
h 69 i 6a 
P 71 q 72 
x 79 y 7a 
/usr/pub/ascii 


stx 
al 
de2 


sub 
n” 


eae OroN Wow 


are rN Dow 


003 
013 
023 
033 
043 
053 
063 
073 
103 
113 
123 
183 
143 
153 
163 
173 


03 
Ob 
13 
1b 
23 
2b 
33 
3b 
43 
4b 
53 
5b 
63 
6b 
73 
7b 


etx 004 


vt O14 
de3 024 
esc 034 
# 044 
+ 064 
3 064 
; 074 
Cc 104 
K 114 
Ss 124 
| 134 
id 144 
k 164 
8 164 
{ 174 
etx 04 


vt Oc 
dc3 14 
esc le 


ot 
ro 
a 


nara —-NnNKROQ:: 
on 
rhe 


eot 005 enq 006 
np O16 cr 016 
dc4 025 nak 026 


fs 0385 gs 036 
$ 045% 046 
, 055 - 056. 
4 066 & 066 
< 075 = 076 
D 105 E 106 
L 115M 116 
T 126 U 126 
\ 188 |] 186 
d 145 e 146 
1 155 m 156 
t 165 u 166 
175 } 176 
eot 05 enq 06 


op Od er Oe 
de4 15 nak 16 


fs ld ges le 
$ 25 % 26 
A 2d - 2e 
4 35 6 36 
< 3d = 3e 
D 45 E 46 
L 4d M 4e 
T 65 U 56 
\ 6d | be 
d 6h e 66 
1 6d m Ce 
t 75 76 

7d } Te 


ack 007 
so 017 
syn 027 
rs 037 
& 047 
057 
6 067 
> O77 
F 107 
N 117 
V127 
: 137 
f 147 
a 157 
v 167 
7 177 


bel 
si 
etb 
us 


SEo0oawarm \. 


atom} 


oO 
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NAME 


DEVICES(5) 


Devices — configuration file for uucp communications 
lines 


SYNOPSIS 


/usr/lib/uucp/Devices 


DESCRIPTION 


/usr/lib/uucp/Devices is a text file that contains 
configuration specifications for communications devices, 
such as modems or direct lines. Each line in the file 
describes a single device and how it communicates with a 
remote system. Comment lines begin with a pound sign 
. The UUCP system uses the 
/usr/lib/uucp/Devices file in conjunction with the 
/usr/lib/uucp/Dialers file to place a call. 


Each line containes five or more fields delimited by 
spaces. The first field is the line type as specified in the 

usr/lib/uucp/Systems file; for direct lines, the first 
field is the name of the remote system. 


The remaining fields give the device name; the calling 
device indicator (such as for 801 calling units), if used; 
the speed, which may be specified as ANY; and the 
name of the caller as_ specified in the 
/usr/lib/uucp/Dialers file. The last field, the name 
of the caller, may be followed by a token format 
peop esne \y or \T); pairs of these dialer name/token 
ormat fields can be repeated if more than one dialer 
must be used in succession to make the connection. If 
no token format is specified, a \D is used for a dialer 
name that references the /usr/lib/uucp/Dialers file; a 
\T is used for internal dialer types such as 801. Unused 
fields are replaced by a hyphen (—). 


EXAMPLE 


FILES 


The following entry configures a 1200-baud intelligent 
modem on device contty for use with UUCP: 


ACU contty - 1200 penril 


/usr/lib/uucp/Devices 
/usr/lib/uucp/Dialers 
/usr/lib/uucp/Systems 


SEE ALSO 
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uucp(1C), dial(3C), Dialers(5). 
MightyFrame Administrator’s Reference Manual. 
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NAME 

Dialers — ACU/modem calling protocols 
SYNOPSIS 

/usr /lib/uucp/Dialers 
DESCRIPTION 


5/86 


Dialers describes the _ call-placing protocols for 
intelligent modems, ACUs (automatic calling units), and 
other serial switched devices such as data switches. 
When a connection is requested via the UUCP system, 
CTIX looks for a description of the called system in the 
/usr/lib/uucp/Systems file, where the type of line is 
specified for connection to that system. CTIX then 
checks the /usr/lib/uucp/Devices file for a 
description of the line, its speed and its Dialers name. 
The Dialers name given in the Devices file corresponds 
to the first field of the Dialers file. 


Dialers is a text file that contains the dialing script for 
the modems that are configured in the Devices file. 
Each description begins on a new line and has three or 
more fields, delimited by spaces. 


The first field of the description is the name of the 
modem or device as specified in the Devices file. 


The second field specifies the codes used by that 
particular modem for secondary dial tone (=) and pause 
(-); this field enables CTIX to translate from the 
standard 801 codes (= and —) to the special characters 
used by that particular device. 


The remaining fields are the chat script that is necessary 
to establish communication with the modem. 


The modem chat script is composed of command strings 
to the modem and response strings expected in return 
from the modem. The strings consist of ASCII and 
control characters that are recognized by the individual 
modem or device. Spaces delimit the end of a send or 
receive sequence. The first string is an expect string. 


Several modems and switches are already provided in the 
Dialers file. Additional devices can be configured by 
studying the manufacturers’ manuals to determine the 
appropriate send/receive sequences for other modems. 


In the string sequences of the send/receive fields the 
following escape sequences represent control codes: 
\ddd Octal number. 


\c Suppress new line (valid only after \r or at the 
end of a field). 
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\d Delay (two seconds). 


\D Substitute the telephone number (from the 
/usr/lib/uucp/Systems file or cu(1C)), 
without character translation. 


\e Turn off echo checking. 


\E Turn on echo checking (for slow devices). 

\K Insert a BREAK. 

\n New-line. 

\p Pause (a slight delay of one-quarter to one-half 
second). 

\r Carriage return. 


\T Substitute the telephone number (from the 
/usr/lib/uucp/Systems file or cu(1C)), with 
character translation. Character translation 
interprets the 801 codes in the second field and 
expands any symbols’ found in _ the 
/usr/lib/uucp/Dialcodes file. 


Comments delimited by a pound sign (#), spaces, or 
tabs are ignored. Any line terminated by a backslash (\) 
continues to the next line. 


EXAMPLE 


FILES 


5/86 


The following example establishes communication with a 
Ventel modem: 


ventel =&-% “"\r\p\r\c $ <K\T%%\r>\c ONLINE! 


The first field, ‘‘ventel,” is the name of the modem that 
corresponds to a “‘ventel’’ caller type in the fifth or 
subsequent field of a Devices file entry. The second 
field describes the modem’s convention for the secondary 
dial tone (&) and a pause (%) command. The 
remaining fields consist of five strings separated by 
spaces. The five strings are interpreted as follows: 


1. The first expect string (””) is null. 


2. Send to the modem a series of carriage returns to 
elicit a prompt. 


3. The modem should respond with a dollar sign ($). 
4. Send the telephone number (\T) to the modem. 


5. Upon connection the modem should respond with the 
string "ONLINE!. 


/usr/lib/uucp/Devices 
/usr/lib/uucp/Dialcodes 
/usr/lib/uucp/Systems 


-2- 


DIALERS (5) 


SEE ALSO 
uucp(1C), dial(3C), Devices(5). 
MightyFrame Administrator’s Reference Manual. 
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NAME 


ENVIRON(5) 


environ — user environment 


DESCRIPTION 


An array of strings called the “environment” is made 
available by exec(2) when a process begins. By 
convention, these strings have the form ‘‘name=value’’. 
The following names are used by various commands: 


PATH The sequence of directory prefixes that sh(1), 
time(1), nice(1), nohup(1), etc., apply in 
searching for a file known by an incomplete path 
name. The prefixes are separated by colons (:). 
Login(1) sets PATH=:/bin:/usr/bin. 

HOME Name of the user’s login directory, set by 
login(1) from the password file passwd(4). 

TERM The kind of terminal for which output is to be 
prepared. This information is used _ by 
commands, such as mm(l), or tplot(1G), which 
may exploit special capabilities of that terminal. 

TZ Time zone information. The format is xxxnzzz 
where xxx is standard local time zone 
abbreviation, n is the difference in hours from 
GMT, and zzz is the abbreviation for the 
daylight-saving local time zone, if any; for 
example, EST5EDT. 


Further names may be placed in the environment by the 
export command and “name=value” arguments in 
sh(1), or by ezec(2). It is unwise to conflict with certain 
shell variables that are frequently exported by .profile 
files: MAIL, PS1, PS2, IFS. 


SEE ALSO 


env(1), lo , hice(1), nohu ime 
ia Si} oxecta) yoienv och, monte ee i 
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NAME 
eqnchar — special character definitions for eqn and neqn 
SYNOPSIS 
eqn /usr/pub/eqnchar | files | | troff [| options | 
neqn /usr/pub/eqnchar | files | | nroff [ options | 
DESCRIPTION 
Egqnchar contains troff(1) and nroff character definitions 
for constructing characters that are not available on the 
Wang Laboratories, Inc. C/A/T phototypesetter. These 
definitions are primarily intended for use with egn(1) 
and neqn; egnchar contains definitions for the following 


characters: 
ciplus ® \ I square 9 
citimes @ langle ( circle oO 
wig ~ rangle } blot a 
—wig = hbar h bullet e 
> wig > ppd L prop x 
< wig < <=>. - empty @ 
= wig = <=> —_ member € 
star * |< t nomem ¢ 
bigstar * |> > cup U 
=dot = ang L cap fa) 
orsign Vv rang L incl ey 
andsign = 3dot : subset Cc 
=del 3 thf ft supset = 
oppA Vv quarter Y subset Gc 
oppE =| 3quarter %, 'supset 2 
angstrom A degree © 
o= ==< ==> ==> 
FILES 
/usr/pub/eqnchar 
SEE ALSO 


eqn(1), nroff(1), troff(1). 
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NAME 
fentl — file control options 


SYNOPSIS 
#include <fentl.h> 
DESCRIPTION 
The fentl(2) function provides for control over open files. 


The include file describes requests and arguments to 
fentl and open(2). 


/* Flag values accessible to open(2) and fentl(2) */ 
/* (The first three can only be set by open) */ 


#define O_RDONLY 0 
#define O_WRONLY 1 
#define O_RDWR 2 
#define O_NDELAY 04 /* Non-blocking I/O */ 
#define O_APPEND 010 /* append 
(writes guaranteed at the end) */ 
#define O_SYNC 020 /* synchronous write option */ 
#define O_DIRECT 020000 = /* perform direct I/O */ 


#define O_NODIRECT 040000 =/* disable direct 1/0 */ 


/* Flag values accessible only to open(2) */ 


#define O_CREAT 00400 /* open with file create 
(uses third open arg)*/ 

#define O_TRUNC 01000 /* open with truncation */ 

#define O_EXCL 02000 _—s/* exclusive open */ 


/* fentl(2) requests */ 


#define F_DUPFD 0 /* Duplicate fildes */ 
#define F_GETFD 1 /* Get fildes flags */ 
#define F_SETFD 2 /* Set fildes flags */ 
#define F_GETFL 3 /* Get file flags */ 
#define F_SETFL 4 /* Set file flags */ 
#define F_GETLK 5 /* Get blocking file locks */ 
#define F_SETLK 6 /* Set or clear file locks and fail 
on busy */ 
#define F_SETLKW 7 /* Set or clear file locks and wait 
on busy */ 
/* file segment locking control structure */ 
struct flock { 
short l_type; 
short l_whence; 
long l_start; 
long l_len; /* if O then until EOF +/ 
int Lpid; /* returned with F_LGETLK */ 
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/* file segment locking types */ 


#define FIRDLCK 01 
#define F_WRLCK 02 
#define F_UNLCK 02 
SEE ALSO 


fentl(2), open(2). 
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/* Read lock */ 
/* Write lock */ 
/* Remove locks */ 


MAN(5) 


NAME 
man — macros for formatting entries in this manual 


~~ SYNOPSIS 
nroff —man files 


DESCRIPTION 
These troff(1) macros are used to lay out the format of 
the entries of this manual. A skeleton entry may be 
found in the file /usr/man/u_man/man0/skeleton. 
These macros are used by the man(1) command. 


Any tert argument below may be one to six ‘‘words’’. 
Double quotes ("") may be used to include blanks in a 
“word”. If tezt is empty, the special treatment is 
applied to the next line that contains text to be printed. 
For example, .I may be used to italicize a whole line, or 
-SM followed by .B to make small bold text. By default, 
hyphenation is turned off for nroff, but remains on for 


troff. 


Type font and size are reset to default values before each 
paragraph and after processing font- and size-setting 
macros, e.g., .I, .RB, .SM. Tab stops are neither used 
nor set by any macro except .DT and .TH. 


aie Default units for indents tn are ens. When in is 
omitted, the previous indent is used. This remembered 
indent is set to its default value (7.2 ens in troff, 5 ens in 
nroff-this corresponds to 0.5" in the default page size) 
by .TH, .P, and .RS, and restored by .RE. 

-TH t 8 cn Set the title and entry heading; ¢ is the title, 
8 is the section number, c is extra 
commentary, e.g., ‘local’, n is new manual 
name. Invokes .DT (see below). 

SH tezt Place subhead tezt, e.g., SYNOPSIS, here. 

“SS tert Place sub-subhead tezt, e.g., Options, here. 

-B tezt Make tezt bold. 

JI tert Make tezt italic. 

-SM tert Make tezt 1 point smaller than default point 
size. 

-RI a 6 Concatenate roman a with italic 6, and 
alternate these two fonts for up to six 
arguments. Similar macros _ alternate 
between any two of roman, italic, and bold: 

sae IR .RB .BR IB .BI 

.P Begin a paragraph with normal font, point 
size, and indent. .PP is a synonym for .P 

-HP in Begin paragraph with hanging indent. 

-TP in Begin indented paragraph with hanging tag. 


The next line that contains text to be 
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printed is taken as the tag. If the tag does 
not fit, it is printed on a separate line. 

AP tin Same as .TP tn with tag ¢; often used to get 
an indented paragraph without a tag. 

-RS in Increase relative indent (initially zero). 
Indent all output an extra in units from the 
current left margin. 

-RE k Return to the fth relative indent level 
(initially, K=1; k=O is equivalent to k=1); 
if k is omitted, return to the most recent 
lower indent level. 

-PM m Produces proprietary markings; where m 
may be P for PRIVATE, N for NOTICE, 
BP for BELL LABORATORIES 
PROPRIETARY, or BR_ for BELL 
LABORATORIES RESTRICTED. 


-DT Restore default tab settings (every 7.2 ens in 
troff, 5 ens in nroff). 

-PD v Set the interparagraph distance to v vertical 
spaces. If uv is omitted, set the 


interparagraph distance to the default value 
(0.4v in troff, 1v in nroff). 


The following strings are defined: 


\#R ® in troff, (Reg.) in nroff. 
\+S Change to default type size. 
\*(Tm Trademark indicator. 
The following number registers are given default values 
by .TH: 
IN Left margin indent relative to subheads 
default is 7.2 ens in troff, 5 ens in nroff). 
LL ine length including IN. 
PD Current interparagraph distance. 
CAVEATS 


In addition to the macros, strings, and number registers 
mentioned above, there are defined a number of internal 
macros, strings, and number registers. Except for names 
predefined by troff and number registers d, m, and y, all 
such internal names are of the form XA, where X is one 
of ), J, and }, and A stands for any alphanumeric 
character. 

If a manual entry needs to be preprocessed by cw(1), 
eqn(1) (or negn), and/or ¢b/(1), it must begin with a 
special line (described in man(1)), causing the man 
command to invoke the appropriate preprocessor(s). 


The programs that prepare the Table of Contents and 
the Permuted Index for this Manual assume the NAME 
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section of each entry consists of a single line of input 
that has the following format: 


name[, name, name ...| \- explanatory text 


The macro package increases the inter-word spaces (to 
eliminate ambiguity) in the SYNOPSIS section of each 
entry. 


The macro package itself uses only the roman font (so 
that one can replace, for example, the bold font by the 
constant-width font—see ew(1)). Of course, if the input 
text of an entry contains requests for other fonts (e.g., .I, 
RB, \fI), the corresponding fonts must be mounted. 


/usr/lib/tmac/tmac.an 
/usr/lib/macros/cmp.[nt].[dt].an 
/usr/lib/macros/ucmp.[nt].an 
/usr/man/[ua]_man/man0/skeleton 


SEE ALSO 


BUGS 


man(1), nroff(1). 


If the argument to .TH contains any blanks and is not 
enclosed by double quotes (""), there will be bird- 
dropping-like things on the output. 


NAME 
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math — math functions and constants 


SYNOPSIS 


#include <math.h> 


DESCRIPTION 


FILES 


This file contains declarations of all the functions in the 
Math Library (described in Section 3M), as well as 
various functions in the C Library (Section 3C) that 
return floating-point values. 


It defines the structure and constants used by the 
matherr(3M) error-handling mechanisms, including the 
following constant used as an error-return value: 


HUGE The maximum value of a single- 
precision floating-point number. 


The following mathematical constants are defined for 
user convenience: 


M_E es base of natural logarithms 
e). 

M_LOG2E The base-2 logarithm of e. 

M_LOGI0E The base-10 logarithm of e. 

M_LN2 The natural logarithm of 2. 

M_LN10 The natural logarithm of 10. 

M_PI The ratio of the circumference of 


a circle to its diameter. (There 
are also several fractions of its 
reciprocal and its square root.) 


M_SQRT2 The positive square root of 2. 
M_SORT1_2 The positive square root of 1/2. 


For the definitions of various machine-dependent 
“constants,’”? see the description of the <values.h> 
header file. 


/usr/include/math.h 


SEE ALSO 


intro(3), matherr(3M), values(5). 
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NAME 
mm — the MM macro package for formatting documents 
SYNOPSIS 
mm | options | [ files ] 
nroff —mm | options ] { files | 
nroff —cm [ options | [ files | 
DESCRIPTION 
This package provides a formatting capability for a very 
wide variety of documents. It is the standard package 
used by the BTL typing pools and documentation 
centers. The manner in which a document is typed in 
and edited is essentially independent of whether the 
document is to be eventually formatted at a terminal or 
is to be phototypeset. See the references below for 
further details. 
The —mm option causes nroff and troff(1) to use the 
non-compacted version of the macro package, while the 
—cm option results in the use of the compacted version, 
thus speeding up the process of loading the macro 
package. 
FILES 
/usr/lib/tmac/tmac.m pointer to the non- 
compacted version of 
the package 
/usr/lib/macros/mm [nt] non-compacted 
version of the package 
/usr/lib/macros/cmp.{nt].[dt].m compacted version of 
the package 
/usr/lib/macros/ucmp.|nt].m initializers for the 
compacted version of 
the package 
SEE ALSO 


mm(1), mmt(1), nroff(1). 

MM-Memorandum Macros by D.W. Smith and J.R. 
Mashey. 

Typing Documents with MM by D. W. Smith and E. M. 
Piskorik. 
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must be expressed as an octal sequence; see 
below.) In a string capability, the following 
sequences stand for single characters: 


\zzz (where zzz is one to 
three octal digits) the 
character whose octal 
value is zzz 

\072 colon (:) 

\200 null (\000 doesn’t work) 
\E _ escape (\033) 
\n newline (\012) 
\r_ return (\015) 

\ tab (\011) 
backspace (\010) 

f formfeed (\014) 


z  control-z 


There are four kinds of capabilities: the place call 
capability, basic features capabilities, the send phone 
number capability, and send/receive capabilities. Only 
the place call capability is mandatory. 


Place Call Capability 

pl String capability. Controls the use of the other 
capabilities. The value of the string is a procedure 
made up of the other capabilities. A 
communication program works through pl’s value, 
using each capability as it is encountered; a limited 
control of execution flow is provided by some 
special capabilities. 


Basic Features Capabilities 

Basic features capabilities specify strings used to 
command basic features of the modem. These 
capabilities never appear in the pl value, but are implied 
by other capabilities. The capability descriptions 
indicate which capabilities use basic features capabilities 
and what happens when basic features capabilities are 
undefined. 


ps Primary command start; string capability. The ps 
capability specifies the characters that precede 
modem commands, if required. Used by sz 
capability. 


es Primary command end; string capability. The es 
capability specifies the characters that must follow 
modem commands, if required. Used by sz 
capability. 
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End phone number; string capability. Used by ph 
capability. 


Pause in phone number; string capability. Used by 
ph capability. 


Pause in phone number and wait for dial tone; 
string capability. Used by ph capability. 


Send Phone Number Capability 


ph 


String capability. In a single wrtte(2), send a 
string with three parts: 


1. The ph’s capability’s own value. 


2. The phone number as ASCII digits. Whenever 
the modem should pause, send the value of the 
pa capability, if defined. Whenever the 
modem should pause and wait for a dial tone, 
send the value of the pw capability, if defined. 


3. The value of the eh capability, if defined. 


Send/Receive Capabilities 

end/receive capabilities are different from other 
capabilities in their naming convention. The first 
character of the capability name tells the kind of 
capability. The second character of the name is chosen 
arbitrarily from the lowercase letters and digits and 
identifies the particular capability from others of the 
same kind. 


tz 
sz 


dz 


cz 


String capability. Send the value to the modem. 


String capability. In a single write, send a 
command to the modem. The command has three 
parts: 


1. The value of the ps capability, if defined. 
2. The sz’s cpability’s own value. 
3. The value of the es capability, if defined. 


Numeric capability. Delay for the number of 
seconds specified in the value. 


String capability; value must be a single character. 
Wisk through input from modem until the value is 
read. Put input, up to but not including the 
terminating character, in the wisk buffer, replacing 
the previous contents. 

String capability. Compare value with contents of 
the wisk buffer. Set the comparison flag to 
EQUAL if they match, NOT_EQUAL otherwise. 
Do not modify the comparison flag until you 
execute another ez. 


“i3:< 


nz 


az 


bz 


EXAMPLE 
The 
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Numeric capability. Skip on EQUAL. If the 
comparison flag is EQUAL the next n instructions 
in the pl value are skipped, where n is the value of 
mz. 


Numeric capability. Skip on NOT_EQUAL. If the 
comparison flag is NOT_EQUAL the next n 
instructions in the pl value are skipped, where n is 
the value of nz. 


String capability. Abort on EQUAL. If the 
comparison flag is EQUAL abort the phone call. If 
debug output is specified, print the value of the az 
capability. 

String capability. Abort on NOT_EQUAL. If the 
comparison flag is NOT_EQUAL abort the phone 
call. If debug output is specified, print the value of 
the bz capability. 


Bizcomp apo same above assumes that the 


modem’s 9 configuration: 
TERMINAL / COMPUTER) is down (COMPUTER). 
With this setting, the modem has the following 
characteristics: 


° Commands to the modem must be 
preceded by an STX (\002) and followed 
by a CR (\r). This prevents normal data 
transmissions from being taken for modem 
commands. 


e The modem’s messages to the computer 
are terse. The following two-character 
sequences are diagnostics. 


1CR_ connection made 
2CR_ noconnection or no answer 
7CR . dial tone detected 


A CR is a command prompt. A 
communication program that uses the 
Bizcom 1012 modemcap entry follows the 
following procedure: 


1. (szd5wpd1) Send an STX-Z-CR, 
resetting the modem. Wait five 
seconds, then read the resulting CR. 
Wait another one second. 

2. tet tone dln Send an STX-V-CR 
select tone dialing); read the resulting 

R. Send an STX-Q-CR (toggle busy 
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detection); read the resulting CR. 
Send an STX-X-CR (select transparent 
data mode); read the resulting CR. 
Wait one second. 


(ph) Send an STX-D, then the phone 
number. The phone number should 
include a colon (:) whenever the 
modem should pause to listen for 
another dial tone. The description 
lacks a pa capability, so there is no 
way to pause without waiting for a 
dial tone. 


(wpc7b1) Read until the next CR. If 
the input isn’t ‘7’, abort with the 
debug message “NO DIAL TONE”. 


tvepe za ielb2) Read until the next CR. 
f the input is “2’’, abort with the 
debug message “NO ANSWER”. 
Otherwise, if the input isn’t “‘1”, abort 
with the debug message ‘“‘NO 
ANSWER”. 


(d1) Wait one second. The connection 
is established. 


dial(3C), uucp(1C). 


NAME 
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mptx - the macro package for formatting a permuted 
index 


SYNOPSIS 


nroff —mptx [ options ] [ files | [ options | [ files | 


DESCRIPTION 


FILES 


This package provides a definition for the .xx macro 
used for formatting a permuted index as produced by 
ptz(1). This package does not provide any other 
formatting capabilities such as headers and footers. If 
these or other capabilities are required, the mptz macro 
package may be used in conjuction with the MM macro 
package. In this case, the —mptx option must be 
invoked after the —mm call. For example: 


nroff ~cm —mptx file 
or 
mm - mptx file 


/usr/lib/tmac/tmac.ptx pointer to the non-compacted 
version of the package 

/usr/lib/macros/ptx non-compacted version of the 
package 


SEE ALSO 


mm(1), nroff(1), ptx(1), mm(5). 
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NAME 
mv — a troff macro package for typesetting view graphs 
and slides 

SYNOPSIS 
mvt [ —a | [ options | [ files | 


troff { -a | [ -rX1 ] —mv [ options | [ files ] 
DESCRIPTION 

This package makes it easy to typeset view graphs and 
rojection slides in a variety of sizes. A few macros 
fbriefy described below) accomplish most of the 
ormatting tasks needed in making transparencies. All of 
the facilities of troff(1), ew(1), egn(1), and ¢tb/(1) are 
available for more difficult tasks. 


The output can be previewed on most terminals, and, in 
particular, on the Tektronix 4014, as well as on the 
Versatec printer. For these two devices, specify the 
-rX1 option (this option is automatically specified by 
the mvt command-q.v.—when that command is invoked 
with the -T4014 or —Tvp options). To preview output 
on other terminals, specify the —a option. 


The available macros are: 


[n] [] [d)  Foil-start macro; foil size is to be 
7™ x7" n is the foil number, ¢ is the 
foil identification, d is the date; the 
foil-start macro resets all parameters 
(indent, point size, etc.) to initial 
default values, except for the values 
of ¢ and d arguments inherited from a 
previous foil-start macro; it also 
invokes the .A macro (see below). 


The naming convention for this and 
the following eight macros is that the 
first character of the name (V or S) 
distinguishes between view graphs and 
slides, respectively, while the second 
character indicates whether the foil is 
square (S), small wide (w), small high 
(h), big wide (Ww ), or big high (H). 

lides are skinnier” than the 
corresponding view graphs: the ratio 
of the longer dimension to the shorter 
one is larger for slides than for view 
graphs. As a result, slide foils can be 
used for view graphs, but not vice 
versa; on the other hand, view graphs 
can accommodate a bit more text. 


es 


-Vw [n] [#] 
-Vh [nl] {7 [d] 
“VW {nj [1] [d] 
-VH {nl [:] [d] 
Sw [nl] [e 
Sh [nl [1] (d| 
“SW [nl [1 
SH [nl] [1d (d| 
A [a] 

‘B [m{s] | 
Cc [m {s] |] 
‘DD [m [a] | 
-T string 
Xin] [eel] 
S [pe] (4 
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Same as .VS, except that foil size is 
7" wide x 5! high. 

Same as .VS, except that foil size is 
5! 7H, 

Same as .VS, except that foil size is 
7" x 5.4", 

Same as .VS, except that foil size is 
Ty gl! 

Same as .VS, except that foil size is 
Ty 5, 

Same as .VS, except that foil size is 
5" «x7, 

Same as .VS, except that foil size is 
7x54! 

Same as .VS, except that foil size is 
Tyg! 

Place text that follows at the first 
indentation level (left margin); the 
presence of z suppresses the % line 
spacing from the preceding text. 

Place text that follows at the second 
indentation level; text is preceded by 
a mark; m is the mark (default is a 
large bullet); s is the increment or 
decrement to the point size of the 
mark with respect to the prevailing 
point size (default is 0); if s is 100, it 
causes the point size of the mark to 
be the same as that of the default 
mark. 

Same as .B, but for the third 
indentation level; default mark is a 
dash. 

Same as .B, but for the fourth 
indentation level; default mark is a 
small bullet. 

String is printed as an _ over-size, 
centered title. 

Change the current text indent (does 
not affect titles); in is the indent (in 
inches unless dimensioned, default is 
0); if tn is signed, it is an increment 
or decrement; the presence of a 
invokes the .A macro (see below) and 
passes z (if any) to it. 

Set the point size and line length; p is 
the point size (default is “‘previous’’); 
if p is 100, the point size reverts to 
the imttal default for the current foil- 
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start macro; if p is signed, it is an 
increment or decrement (default is 18 
for .VS, .WH, and .SH, and 14 for 
the other foil-start macros); | is the 
line length (in inches — unless 
dimensioned; default is 4.2" for .Wh, 
3.8" for Sh, 5" for .SH, and 6" for 
the other foil-start macros). 

DF nf [n f...] 
Define font positions; may not appear 
within a foil’s input text (i.e., it may 
only appear after all the input text for 
a foil, but before the next foil-start 
macro); n is the position of font f; up 
to four “‘n f” pairs may be specified; 
the first font named becomes the 
revatling font; the initial setting is 
H is a synonym for G): 

DF 1H213B48 

-DV [a] [6] {c] [d] Alter the vertical spacing between 
indentation levels; a is the spacing for 
.A, 6 is for .B, ¢ is for .C, and d is 
for .D; all non-null arguments must 
be dimensioned; null arguments leave 
the corresponding spacing unaffected; 
initial setting is: 

DV .bv .5v .5v Ov 

-U _—atri [str2]) Underline stri and concatenate str2 
(if any) to it. 

The last four macros in the above list do not cause a 

break; the .I macro causes a break only if it is invoked 

with more than one argument; all the other macros cause 

a break. 


The macro package also recognizes the following upper- 
case synonyms for the corresponding lower-case troff 
requests: 

-BR .CE .FI HY .NA .NF .NH .NX .50O 
SP .TA .TI 


The Tm string produces the trademark symbol. 


The input tilde (~) character is translated into a blank 
on output. 


See the user’s manual cited below for further details. 


/usr/lib/tmac/tmac.v 
/usr/lib/macros/vmca 
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SEE re 


, eqn(1), mmt(1), eu troff(1 
ve Chee te y0 AP kg and Slides by 
A. Dolotta and D. W. Smith. 


BUGS 
whe -VW and .SW foils are meant to be 9! wide by 7!’ 
hee but because the typesetter paper is generally only 
wide, they are printed 7" wide by 5.4" high and have 
. be enlarged by a factor of 9/7 before use as view 
graphs; this makes them less than totally useful. 
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NAME 
prof — profile within a function 


SYNOPSIS 
#define MARK 
#include <prof.h> 


void MARK (name) 


DESCRIPTION 

MARK will introduce a mark called name that will be 
treated the same as a function entry point. Execution of 
the mark will add to a counter for that mark, and 
program-counter time spent will be accounted to the 
immediately preceding mark or to the function if there 
are no preceding marks within the active function. 

Name may be any combination of up to six letters, 
numbers or underscores. Each name in a single 
compilation must be unique, but may be the same as any 
ordinary program symbol. 


For marks to be effective, the symbol MARK must be 
defined before the header file <prof.h> is included. 
This may be defined by a preprocessor directive as in the 
synopsis, or by a command line argument, i.e: 


ce —p -DMARK foo.c 


If MARK is not defined, the MARK(name) statements 
may be left in the source files containing them and will 
be ignored. 


EXAMPLE 
In this example, marks can be used to determine how 
much time is spent in each loop. Unless this example is 
compiled with MARK defined on the command line, the 
marks are ignored. 


#include <prof.h> 
foo( ) 
{ 


int i, j; 


MARK(loop1); 
for (i = 0; 1 < 2000; i++) { 


} 
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MARK(loop2); 
for (j = 0; j < 2000; j++) { 
’ rae 
} 
SEE ALSO 


prof(1), profil(2), monitor(3C). 
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NAME 
regexp — regular expression compile and match routines 


SYNOPSIS 
#define INIT <declarations > 
#define GETC() <getc code> 
##define PEEKC() <peekc code> 
#define PETORNGS <ungetc code> 
#define RETURN(pointer) <return code> 
#define ERROR(val) <error code> 


#finclude <regexp.h> 


char *compile (instring, expbuf, endbuf, eof) 
char *instring, *expbuf, *endbuf; 
int eof; 


int step (string, expbuf) 
char *string, *expbuf; 


extern char *locl, *loc2, *locs; 
extern int circf, sed, nbra; 


DESCRIPTION 
This page describes general-purpose regular expression 
matching routines in the form of ed(1), defined in 
/usr/include/regexp.h. Programs such as ed(1), 
sed(1), grep(1), 6a(1), ezpr(1), etc., which perform 
regular expression matching use this source file. In this 
way, only this file need be changed to maintain regular 
expression compatibility. 
The interface to this file is unpleasantly complex. 
Programs that include this file must have the following 
five macros declared before the “#include <regexp.h>” 
statement. These macros are used by the compile 
routine. 


GETC{( ) Return the value of the next 
character in the regular expression 
pattern. Successive calls to 
GETC() should return successive 
characters of the regular 
expression. 


PEEKC( ) Return the next character in the 
regular expression. Successive 
calls to PEEKC() should return 
the same character (which should 
also be the next character 
returned by GETC( )). 


UNGETC(c) Cause the argument ¢ to be 
returned by the next call to 


oe es 
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GETC() (and PEEKC()}). No 
more that one character of 
pushback is ever needed and this 
character is guaranteed to be the 
last character read by GETC( ). 
The value of the macro 
UNGETC(c) is always ignored. 


RETURN(pointer) This macro is used on normal exit 
of the compile routine. The value 
of the argument pointer is a 
pointer to the character after the 
last character of the compiled 
regular expression. This is useful 
to programs which have memory 
allocation to manage. 


ERROR(val) This is the abnormal return from 
the compile routine. The 
argument val is an error number 
see table below for meanings). 

his call should never return. 


ERROR MEANING 

11 Range endpoint too large. 

16 Bad number. 

25 “\ digit” out of range. 

36 Illegal or missing delimiter. 

41 aC remembered search string. 
42 (\) aan ia 

43 oo many \ 

44 More than 5 numbers given in 
45 pcupecied after \. 

46 irst number exceeds second in 


\ ‘ 
49 [. imbalance. 
egular expression overflow. 
The syntax of the compsle routine is as follows: 
compile(instring, expbuf, endbuf, eof) 


The first parameter instring is never used explicitly by 
the compile routine but is useful for programs that pass 
down different pointers to input characters. It is 
sometimes used in the INIT declaration (see below). 
Programs which call functions to input characters or 
have characters in an external array can pass down a 
value of ((char *) 0) for this parameter. 


The next parameter ezpbuf is a character pointer. It 
points to the place where the compiled regular expression 
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will be placed. 


The parameter endbuf is one more than the highest 
address where the compiled regular expression may be 
laced. If the compiled expression cannot fit in 
lendbuf’ ezpbuf) bytes, a call to ERROR(50) is made. 


The parameter eof is the character which marks the end 
of the regular expression. For example, in ed(1), this 
character is usually a /. 


Each program that includes this file must have a 
#define statement for INIT. This definition will be 
placed right after the declaration for the function 
compile and the opening curly brace ({). It is used for 
dependent declarations and initializations. Most often it 
is used to set a register variable to point the beginning of 
the regular expression so that this register variable can 
be used in the declarations for GETC( ), PEEKC() and 
UNGETC( ). Otherwise it can be used to declare external 
variables that might be used by GETC( ), PEEKC( ) and 
UNGETC(). See the example below of the declarations 
taken from grep(1). 


There are other functions in this file which perform 
actual regular expression matching, one of which is the 
function step. The call to step is as follows: 


step(string, expbuf) 


The first parameter to step is a pointer to a string of 
characters to be checked for a match. This string should 
be null terminated. 


The second parameter ezpbuf is the compiled regular 
expression which was obtained by a call of the function 
comptle. 


The function step returns non-zero if the given string 
matches the regular expression, and zero if the 
expressions do not match. If there is a match, two 
external character pointers are set as a side effect to the 
call to step. The variable set in step is loci. This is a 
pointer to the first character that matched the regular 
expression. The variable loc2, which is set by the 
function advance, points to the character after the last 
character that matches the regular expression. Thus if 
the regular expression matches the entire line, loc! will 
point to the first character of string and loc2 will point 
to the null at the end of string. 


Step uses the external variable ctref which is set by 
compile if the regular expression begins with *. If this is 
set then step will try to match the regular expression to 
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the beginning of the string only. If more than one 
regular expression is to be compiled before the first is 
executed the value of ciref should be saved for each 
compiled expression and ctrcf should be set to that saved 
value before each call to step. 


The function advance is called from step with the same 
arguments as step. The purpose of step is to step 
through the string argument and call advance until 
advance returns non-zero indicating a match or until the 
end of string is reached. If one wants to constrain string 
to the beginning of the line in all cases, step need not be 
called; simply call advance. 


When advance encounters a * or \{ \} sequence in the 
regular expression, it will advance its pointer to the 
string to be matched as far as possible and will 
recursively call itself trying to match the rest of the 
string to the rest of the regular expression. As long as 
there is no match, advance will back up along the string 
until it finds a match or reaches the point in the string 
that initially matched the * or \{ \}. It is sometimes 
desirable to stop this backing up before the initial point 
in the string is reached. If the external character pointer 
locs is equal to the point in the string at sometime 
during the backing up process, advance will break out of 
the loop that backs up and will return zero. This is used 
by ed(1) and sed(1) for substitutions done globally (not 
just the first occurrence, but the whole line) so, for 
example, expressions like s/y*//g do not loop forever. 


The additional external variables sed and nbra are used 
for special purposes. 
EXAMPLES 


The following is an example of how the regular 
expression macros and calls look from grep(1): 


#define INIT register char *sp = instring; 
#define GETC( *sp++) 

#define PEEKC{( ) *sp) 

#define UNGETC(c —~sp) 

#define RETURN(c return; 

#define ERROR(c regerr( ) 


#include <regexp.h> 
(void) compile(*argv, expbuf, &expbuf[ESIZE], '\0'); 
if (step(linebuf, expbuf)) 


succeed ); 
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FILES 
/usr/include/regexp.h 
SEE ALSO 
bs(1), ed(1), expr(1), grep(1), sed(1). 
BUGS 
The handling of ctref is kludgy. 
The actual code is probably easier to understand than 
this manual page. 


NAME 


am 


1 


DESCRIPTION 


FILES 
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stat — data returned by stat system call 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/stat.h> 


The system calls stat and fetat return data whose 
structure is defined by this include file. The encoding of 
the field st_mode is defined in this file also. 


/* 


* Structure of the result of stat 


‘7 


struct 


{ 


i 


#define 
#define 
# define 
#define 
# define 
#define 
#define 
#define 


#define 


#define 
#define 


#define 


stat 


dev_t 
ino_t 
ushort 
short 
ushort 
ushort 
dev_t 
off_t 
time_t 
time_t 
time_t 


SIFMT 


st_dey; 
st_ino; 
st_mode; 
st_nlink; 
st_uid; 
st_gid; 
st_rdey; 
st_size; 
st_atime; 
st_mtime; 
st_ctime; 


0170000 


S_IFDIR 0040000 
S_IFCHR 0020000 
S_IFBLK 0060000 
S_IFREG 0100000 
S_IFIFO 0010000 
S_ISUID 04000 

S_ISGID 02000 


S_ISVTX 01000 


S_IREAD 00400 
S_IWRITE 


00200 


S_IEXEC 00100 
/* execute/search permission, owner */ 


/* type of file */ 

/* directory */ 

/* character special */ 

/* block special */ 

/* regular */ 

/* fifo #/ 

/* set user id on execution */ 


/* set group id on execution #/ 


/* save swapped text even after use */ 
/* read permission, owner */ 


/* write permission, owner */ 


/usr/include/sys/types.h 
/usr/include/sys/stat.h 


oe 


STAT (5) 


SEE ALSO 
stat(2), types(5). 


NAME 


TERM (5) 


term — conventional names for terminals 


DESCRIPTION 


— These names are used by certain commands (e.g., 
tabs(1), Mh ) and are maintained as part of the shell 


environment (see  h(1), profile(4), and environ(5)) in the 

variable $TERM 

pt Couveneit Technologies Programmable 
Terminal 

gt Convergent Technologies Graphics Terminal 

freedom Liberty Freedom 100 

1520 Datamedia 1520 

1620 DIABLO 1620 and others using the HyType II 
printer 

1620-12 
same, in 12-pitch mode 

2621 Hewlett-Packard HP2621 series 

2631 Hewlett-Packard 2631 line printer 

2631-c Hewlett-Packard 2631 line printer - compressed 
mode 

263l-e Hewlett-Packard 2631 line printer - expanded 
mode 

2640 Hewlett-Packard HP2640 series 

om 2645 Hewlett-Packard HP264n series (other than the 

2640 series) 

300 DASI/DTC/GSI] 300 and others using the 
HyType I printer 

300-12 same, in 12-pitch mode 

300s  DASI/DTC/GSI 300s 

382 DTC 382 

300s—12 same, in 12-pitch mode 

3045 Datamedia 3045 

33 TELETYPE Mode] 33 KSR 

37 TELETYPE Model 37 KSR 

40-2 TELETYPE Model 40/2 

40-4 TELETYPE Model 40/4 

4540 TELETYPE Model 4540 

3270 IBM Model 3270 

4000a Trendata 4000a 

4014 TEKTRONIX 4014 

43 TELETYPE Model 43 KSR 

450 DASI 450 (same as Diablo 1620) 

450-12 same, in 12-pitch mode 

oo 735 Texas Instruments TI735 and T1725 
745 Texas Instruments T1745 
dumb generic name for terminals that lack reverse 


line-feed and other special escape sequences; 
likely to work when the real terminal type is 


ea 


TERM(5) 


not known to the program 

sync generic name for synchronous TELETYPE 4540- 
compatible terminals 

Ip generic name for a line printer 


Up to 8 characters, chosen from [-a—z0—9], make up a 
basic terminal name. Terminal sub-models and 
operational modes are distinguished by suffixes beginning 
with a —. Names should generally be based on original 
vendors, rather than local distributors. A terminal 
acquired from one vendor should not have more than one 
distinct basic name. 


Commands whose behavior depends on the type of 
terminal should accept arguments of the form —Tfterm 
where term is one of the names given above; if no such 
argument is present, such commands should obtain the 
terminal type from the environment variable $TERM, 
which, in turn, should contain term. 


SEE ALSO 


BUGS 


amabtl), mm(1), nroff(1), tplot(1G), sh(1), stty(1), tabs(1), 
profile(4), environ(5). 


This is a small candle trying to illuminate a large, dark 
problem. Programs that ought to adhere to this 
nomenclature do so somewhat fitfully. 


NAME 


TYPES (5) 


types — primitive system data types 


SYNOPSIS 


#include <sys/types.h> 


DESCRIPTION 


The data types defined in the include file are used in 


CTIX code; some data of these types are accessible 


user code: 


typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 


struct { int r{1]; 


long 


char * 


unsigned int 
unsigned short 


ushort 


short 
long 
int 
short 
long 
long 
long 


: * physadr; 
a 


ddr_t; 
caddr_t; 
uint; 
ushort; 
ino_t; 
cnt_t; 
time_t; 
label_t[13]; 
dev_t; 
off_t; 
paddr_t; 
key_t; 


to 


The form daddr_t is used for disk addresses except in an 
i-node on disk, see fs(4). Times are encoded in seconds 
since 00:00:00 GMT, January 1, 1970. The major and 
minor parts of a device code specify kind and unit 
number of a device. Offsets are measured in bytes from 
the beginning of a file. The label_t variables are used to 
save the processor state while another process is running. 


SEE ALSO 
fs(4). 


NAME 


VALUES (5) 


values — machine-dependent values 


SYNOPSIS 


#include <values.h> 


DESCRIPTION 


This file contains a set of manifest constants, 
conditionally defined for particular processor 
architectures. 


The model assumed for integers is binary representation 
(one’s or two’s complement), where the sign is 
represented by the value of the igh-order bit. 


BITS(type ) The number of bits in a specified 
type (e.g., int). 
HIBITS The value of a short integer with 


only the high-order bit set (in 
most implementations, 0x8000). 


HIBITL The value of a long integer with 
only the high-order bit set (in 
most implementations, 
0x80000000). 

HIBITI The value of a regular integer 


with only the high-order bit set 
(usually the same as HIBITS or 


HIBITL). 

MAXSHORT The maximum value of a signed 
short integer (in most 
implementations, Ox7FFF = 
32767). 

MAXLONG The maximum value id a poe 
long integer 
implementations, 0x7 FFFFFF = 
2147483647). 

MAXINT The maximum value of a signed 


regular integer (usually the same 
as MAXSHORT or MAXLONG). 


MAXFLOAT, LN_MAXFLOAT The maximum value of 
a single-precision 
floating-point number, 
and its natural 
logarithm. 

MAXDOUBLE, LN_MAXDOUBLE The maximum value of 
a double-precision 
floating-point number, 
and its natural 
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logarithm. 
MINFLOAT, LN_MINFLOAT The minimum positive 
value of a single- 
~ precision floating-point 
number, and its 
natural logarithm. 

MINDOUBLE, LN_MINDOUBLE The minimum positive 

value of a  double- 
precision floating-point 
number, and its 
natural logarithm. 

FSIGNIF The number of significant bits in 
the mantissa of a single-precision 
floating-point number. 

DSIGNIF The number of significant bits in 
the mantissa of a double-precision 
floating-point number. 

FILES 
/usr/include/values.h 
SEE ALSO 
intro(3), math(5). 
-_ 
_— 


VARARGS(5) 


NAME 

varargs — handle variable argument list 
SYNOPSIS 

#include <varargs.h> 

va_alist 

va_dcl 


void va_start(pvar) 
va_list pvar; 


type va_arg(pvar, type) 
va_list pvar; 
void va_end(pvar) 
va_list pvar; 

DESCRIPTION 
This set of macros allows portable procedures that 
accept variable argument lists to be written. Routines 
that have variable argument lists (such as printf{(3S)) but 
do not use varargs are inherently nonportable, as 
different machines use different argument-passing 
conventions. 


va_alist is used as the parameter list in a function 
header. 


va_dcl is a declaration for va_altst. No semicolon 
should follow va_del. 


va_list is a type defined for the variable used to 
traverse the list. 


va_start is called to initialize pvar to the beginning of 
the list. 

va_arg will return the next argument in the list pointed 
to by pvar. Type is the type the argument is expected 
to be. Different types can be mixed, but it is up to the 
routine to know what type of argument is expected, as it 
cannot be determined at runtime. 


va_end is used to clean up. 


Multiple traversals, each bracketed by va_start 
va_end, are possible. 

EXAMPLE 
This example is a possible implementation of ezecl(2). 


#include <varargs.h> 
#define MAXARGS 100 


/* execl is called by 
execl(file, argl, arg2, ..., (char *)0); 


-l- 
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x 


execl(va_alist) 
va_del 


va_list ap; 
char *file; 
char *args[MAXARGS]; 


int argno = 0; 


va_start(ap); 

file = va_arg(ap, char *); 

while ((args[argno++] = va_arg(ap, char *)) 
!== (char *)0) 


ya_end(ap); 
return execv(file, args); 


} 


SEE ALSO 


BUGS 


exec(2), printf(3S). 


It is up to the calling routine to specify how many 
arguments there are, since it is not always possible to 
determine this from the stack frame. For example, exec! 
is passed a zero pointer to signal the end of the list. 
Printf can tell how many arguments are there by the 
format. 

It is non-portable to specify a second argument of char, 
short, or float to va_arg, since arguments seen by the 
called function are not char, short, or float. C converts 
char and short arguments to int and converts float 
arguments to double before passing them to a function. 


INTRO(6) 


NAME 
intro — introduction to games 


DESCRIPTION 
This section describes the recreational and educational 
programs found in the directory /usr/games. The 
availability of these programs may vary from system to 
system. 


ADVENT (6) 


NAME 

advent — explore Colossal Cave 
SYNOPSIS 

/usr/games/advent 
DESCRIPTION 


Advent is Adventure, the original computer-moderated 
role-playing game. It accepts commands of one or two 
English words and responds by describing situations and 
how your commands affect them. The object of the 
game is to retrieve the treasures from Colossal Cave, 
placing them in the Well House. 


Part of the game is figuring out the useful commands, 
but the following are worth knowing in advance: 


help Basic hints. 
quit End the game and give final score. 


suspend Save the game’s current state in a file called 
$HOME/adv.susp. The next time you play 
the game will you automatically start from 
where you left off instead of from the 


beginning. 
FILES hus) / ) 
usr/games/advfiles/* 
$HOME/adv.susp 
WARNINGS 


Kibitzing this sort of game properly is a fine art. People 
who tell you about the shortcuts can spoil the game, 
especially in the early stages. 


Some movement verbs, such as follow, work only well 
enough to get you lost. Compass points are more (but 
not completely) reliable. 


Only the first five characters of an input word are 
significant. 


The command vocabulary and control of objects is 
limited. But discovering limitations has become part of 
the game. 


ARITHMETIC (6) 


NAME 

arithmetic — provide drill in number facts 
SYNOPSIS 

/usr/games/arithmetic | +-—x/ | [ range | 
DESCRIPTION 


Artthmetic types out simple arithmetic problems, and 
waits for an answer to be typed in. If the answer is 
correct, it types back “‘Right!”’, and a new problem. If 
the answer is wrong, it replies ‘“What?”, and waits for 
another answer. Every twenty problems, it publishes 
statistics on correctness and the time required to answer. 


To quit the program, type an interrupt (delete). 


The first optional argument determines the kind of 
problem to be generated; +, —, x, and / respectively 
cause addition, subtraction, multiplication, and division 
problems to be generated. One or more characters can 
be given; if more than one is given, the different types of 
problems will be mixed in random order; default is +~. 


Range is a decimal number; all addends, subtrahends, 
differences, multiplicands, divisors, and quotients will be 
less than or equal to the value of range. Default range 
is 10. 


At the start, all numbers less than or equal to range are 
equally likely to appear. If the respondent makes a 
mistake, the numbers in the problem which was missed 
become more likely to reappear. 


As a matter of educational philosophy, the program will 
not give correct answers, since the Jearner should, in 
principle, be able to calculate them. Thus the program 
is intended to provide drill for someone just past the first 
learning stage, not to teach number facts de novo. For 
almost all users, the relevant statistic should be time per 
problem, not percent correct. 


NAME 


BACK (6) 


back — the game of backgammon 


SYNOPSIS 


/usr /games/back 


DESCRIPTION 


FILES 


BUGS 


Back is a program which provides a partner for the game 
of backgammon. It is designed to play at three different 
levels of skill, one of which you must select. In addition 
to selecting the opponent’s level, you may also indicate 
that you would like to roll your own dice during your 
turns (for the superstitious players). You will also be 
given the opportunity to move first. The practice of 
each player rolling one die for the first move is not 
incorporated. 


The points are numbered 1-24, with 1 being white’s 
extreme inner table, 24 being brown’s inner table, 0 
being the bar for removed white pieces and 25 the bar 
for brown. For details on how moves are expressed, type 
y when back asks “Instructions?” at the beginning of the 
game. When back first asks ‘“Move?’’, type ? to see a 
list of move options other than entering your numerical 
move. 


When the game is finished, back will ask you if you want 
the log. If you respond with y, back will attempt to 
append to or create a file back.log in the current 
directory. 


log temp file 
ae log log file 


; ried ith br /lib/backrules __ rules file 


The only level really worth playing is ‘“‘expert’’, and it 
only plays the forward game. 

Back will complain loudly if you attempt to make too 
many moves in a turn, but will become very silent if you 
make too few. 

Doubling is not implemented. 

Back will occasionally not allow a legal move when you 
have a man on the bar. 


BJ(6) 


NAME 
bj -— the game of black jack 
SYNOPSIS 
/usr/games/bj 
DESCRIPTION 
Bj is a serious attempt at simulating the dealer in the 


game of black jack (or twenty-one) as might be found in 
Reno. The following rules apply: 


The bet is $2 every hand. 


A player “natural” (black jack) pays $3. A dealer 
natural loses $2. Both dealer and player naturals is 
a “push” (no money exchange). 


oo 


If the dealer has an ace up, the player is allowed to 
make an “insurance” bet against the chance of a 
dealer natural. If this bet is not taken, play 
resumes as normal. If the bet is taken, it is a side 
bet where the player wins $2 if the dealer has a 
natural and loses $1 if the dealer does not. 


If the player is dealt two cards of the same value, 
he is allowed to ‘“‘double”. He is allowed to play 
two hands, each with one of these cards. (The bet 
is doubled also; $2 on each hand. ) 


If a dealt hand has a total of ten or eleven, the 

player may ‘‘double down’. He may double the 
bet ($2 to $4) and receive exactly one more card on 
that hand. 


Under normal play, the player may “hit” (draw a 
card) as long as his total is not over twenty-one. If 
the player ‘‘busts” (goes over twenty-one), the 
dealer wins the bet. 


When the player ‘“‘stands’’ (decides not to hit), the 
dealer hits until he attains a total of seventeen or 
more. If the dealer busts, the player wins the bet. 


If both player and dealer stand, the one with the 
largest total wins. A tie is a push. 


The machine deals and keeps score. The following 

questions will be asked at appropriate times. Each 

question is answered by ¥ followed by a new-line for 
sale ‘“‘ves’’, or just new-line for ‘“‘no”’ 


? (hens, “‘do you want a hit?’’) 
Insurance? 
Double down? 
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Every time the deck is shuffled, the dealer so states and 
the “action” (total bet) and “standing” (total won or 
lost) is printed. To exit, hit the interrupt key (DEL) and 
the action and standing will be printed. 


NAME 


CRAPS(6) 


craps — the game of craps 


SYNOPSIS 


/usr/games/craps 


DESCRIPTION 


Craps is a form of the game of craps that is played in 
Las Vegas. The program simulates the roller, while the 
user (the player) places bets. The player may choose, at 
any time, to bet with the roller or with the House. A 
bet of a negative amount is taken as a bet with the 
House, any other bet is a bet with the roller. 


The player starts off with a “bankroll” of $2,000. 
The program prompts with: 
bet? 


The bet can be all or part of the player’s bankroll. Any 
bet over the total bankroll is rejected and the program 
prompts with bet? until a proper bet is made. 


Once the bet is accepted, the roller throws the dice. The 
following rules apply (the player wins or loses depending 
on whether the bet is placed with the roller or with the 
House; the odds are even). The first roll is the roll 
immediately following a bet: 


1. On the first roll: 


7 or ll wins for the roller; 

2, 3, or 12 wins for the House; 

any other number is the point, roll again 
(Rule 2 applies). 


2. On subsequent rolls: 
point roller wins; 
House wins; 
any other number oll again. 


If a player loses the entire bankroll, the House will offer 
to lend the player an additional $2,000. The program 
will prompt: 

marker? 


A yes (or y) consummates the loan. Any other reply 
terminates the game. 


If a player owes the House money, the House reminds the 
player, before a bet is placed, how many markers are 
outstanding. 


If, at any time, the bankroll of a player who has 
outstanding markers exceeds $2,000, the House asks: 
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Repay marker? 


A reply of yes (or y) indicates the player’s willingness to 
repay the Joan. If only 1 marker is outstanding, it is 
immediately repaid. However, if more than 1 marker are 
outstanding, the House asks: 


How many? 


markers the player would like to repay. If an invalid 
number is entered (or just a carriage return), an 
appropriate message 1s printed and the program will 
prompt with How many? until a valid number is 
entered. 


If a player accumulates 10 markers (a total of $20,000 
borrowed from the House), the program informs the 
player of the situation and exits. 


Should the bankroll of a player who has outstanding 
markers exceed $50,000, the total amount of money 
borrowed will be automatically repaid to the House. 


Any player who accumulates $100,000 or more breaks 
the bank. The program then prompts: 


New game? 
to give the House a chance to win back its money. 


Any reply other than yes is considered to be a no 
(except in the case of bet? or How many?). To exit, 
send an interrupt (break), DEL, or control-D. The 
program will indicate whether the player won, lost, or 
broke even. 


MISCELLANEOUS 
The random number generator for the die numbers uses 
the seconds from the time of day. Depending on system 
usage, these numbers, at times, may seem strange but 
occurrences of this type in a real dice situation are not 
uncommon. 


am 


NAME 


FISH(6) 


fish — play “Go Fish” 


SYNOPSIS 


/usr /games/fish 


DESCRIPTION 


Fish plays the game of Go Fish, a childrens’ card game. 
The Object is to accumulate ‘books’ of 4 cards with the 
same face value. The players alternate turns; each turn 
begins with one player selecting a card from his hand, 
and asking the other player for all cards of that face 
value. If the other player has one or more cards of that 
face value in his hand, he gives them to the first player, 
and the first player makes another request. Eventually, 
the first player asks for a card which is not in the second 
player’s hand: he replies ‘GO FISH!’ The first player 
then draws a card from the ‘pool’ of undealt cards. If 
this is the card he had last requested, he draws again. 
When a book is made, either through drawing or 
requesting, the cards are laid down and no further action 
takes place with that face value. 


To play the computer, simply make guesses by typing a, 
2, 3, 4, 5, 6, 7, 8, 9, 10, j, q, or k when asked. Hitting 
return gives you information about the size of my hand 
and the pool, and tells you about my books. Saying ‘p’ 
as a first guess puts you into ‘pro’ level; the default is 
pretty dumb. 


FORTUNE(6) 


NAME 

fortune — print a random, hopefully interesting, adage 
SYNOPSIS 

/usr/games/fortune { — | [ —wslao | 


DESCRIPTION 
Fortune with no arguments prints out a random adage. 
The flags mean: 


-w Waits before termination for an amount of time 
calculated from the number of characters in the 
message. This is useful if it is executed as part of 
the logout procedure to guarantee that the message 
can be read before the screen is cleared. 


—s Short messages only. 
-] Long messages only. 


~o Choose from an alternate list of adages, often used 
for potentially offensive ones. 


—a Choose from either list of adages. 


FILES 
/usr/games/lib/fortunes.dat 


AUTHOR 
Ken Arnold 


NAME 


HANGMAN(6) 


hangman — guess the word 


SYNOPSIS 


/usr/games/hangman | arg | 


DESCRIPTION 


FILES 


BUGS 


Hangman chooses a word at least seven letters long from 
a dictionary. The user is to guess letters one at a time. 


The optional argument arg names an_ alternate 
dictionary. 


/usr/lib/w2006 


Hyphenated compounds are run together. 
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NAME 
maze — generate a maze 

SYNOPSIS 
/usr/games/maze [ seed [d][{n] [ b ] ] 

DESCRIPTION 
Maze prints a maze. It uses the system clock as the 
random number seed. If seed is specified, maze uses it 
as the seed and shows the solution. An n suppresses the 
solution, a b shows backouts, and a d_ provides 
debugging information. 

BUGS 


Some mazes (especially small ones) have no solutions. 


MOO(6) 


NAME 
moo — guessing game 


SYNOPSIS 
/usr/games/moo 

DESCRIPTION 
Moo is a guessing game imported from England. The 
computer picks a number consisting of four distinct 
decimal digits. The player guesses four distinct digits 
being scored on each guess. A “cow” is a correct digit in 
an incorrect position. A ‘‘bull’’ is a correct digit in a 
correct position. The game continues until the player 
guesses the number (a score of four bulls). 


NUMBER (6) 


NAME 
number — convert Arabic numerals to English 


SYNOPSIS 
/usr/games/number 


DESCRIPTION 
Number copies the standard input to the standard 
output, changing each decimal number to a fully spelled 
out version. 


NAME 


QUIZ(6) 


quiz — test your knowledge 


SYNOPSIS 


/usr/games/quiz [ -i file | [| -—t | [ categoryl 
category2 | 


DESCRIPTION 


FILES 


BUGS 


Quiz gives associative knowledge tests on various 
subjects. It asks items chosen from categoryl and 
expects answers from category2, or vice versa. If no 
categories are specified, qutz gives instructions and lists 
the available categories. 


Qutz tells a correct answer whenever you type a bare 
new-line. At the end of input, upon interrupt, or when 
questions run out, gutz reports a score and terminates. 


The —t flag specifies ‘‘tutorial’? mode, where missed 
questions are repeated later, and material is gradually 
introduced as you learn. 


The —i flag causes the named file to be substituted for 
the default index file. The lines of these files have the 
syntax: 
line 
category 
alternate 
primary 
option 


category new-line | category : line 
alternate category | alternate 
empty | alternate primary 
character | [ category | | option 

{ category } 


The first category on each line of an index file names an 
information file. The remaining categories specify the 
order and contents of the data in each line of the 
information file. Information files have the same syntax. 
Backslash \ is used as with sh(1) to quote syntactically 
significant characters or to insert transparent new-lines 
into a line. When either a question or its answer is 
empty, qutz will refrain from asking it. 


/usr/games/lib/quiz /index 
/usr/games/lib/quiz/* 


The construct ‘‘a| ab” does not work in an information 


file. Use “a{b}”. 


TRK(6) 


NAME 
trk — trekkie game 


SYNOPSIS 
/usr/games/trk { { —a | file ] 


DESCRIPTION 
Trk is a game of space glory and war. Below is a 


summary of commands. For complete documentation, 
see Trek by Eric Allman. 


If a filename is given, a log of the game is written onto 
that file. If the —a flag is given before the filename, 
that file is appended to, not truncated. 


The game will ask you what length game you would like. 
Valid responses are ‘‘short’’, ‘“‘medium’’, and “‘long”’. 
You may also type “‘restart’’, which restarts a previously 
saved game. You will then be prompted for the skill, to 
which you must respond ‘“‘novice’, “fair”, ‘‘good”’, 
“expert”, ‘“commadore”, or “impossible”. You should 
normally start out as a novice and work up. 


In general, throughout the game, if you forget what is 
appropriate, the game will tell you what it expects if you 
just type in a question mark. 


COMMAND SUMMARY 
abandon 
capture 
cloak up/down 
computer request; ... 
damages 
destruct 
dock 
help 
impulse course distance 
Irscan 
move course distance 
phasers automatic amount 
phasers manual amtl coursel spread] ... 
torpedo course [yes] angle/no 
ram course distance 
rest time 
shell 
shields up/down 
srscan [yes/no} 
status 
terminate [yes/no] 
undock 
visual course 
warp warp_factor 


TTT(6) 


NAME 
ttt, cubic — tic-tac-toe 

SYNOPSIS 
/usr/games/ttt 
/usr/games/cubic 

DESCRIPTION 
Tit is the X and O game popular in the first grade. This 
is a learning program that never makes the same mistake 
twice. 


Although it learns, it learns slowly. It must lose nearly 
80 games to completely know the game. 
Cubte plays three-dimensional tic-tac-toe on a 4x4x4 
board. Moves are specified as a sequence of three 
coordinate numbers in the range 1-4. 

FILES 
/usr/games/ttt.k learning file 


WUMP (6) 


NAME 

wump — the game of hunt-the-wumpus 
SYNOPSIS 

/usr /games/wump 
DESCRIPTION 


BUGS 


Wump plays the game of “Hunt the Wumpus.” A 
Wumpus is a creature that lives in a cave with several 
rooms connected by tunnels. You wander among the 
rooms, trying to shoot the Wumpus with an arrow, 
meanwhile avoiding being eaten by the Wumpus and 
falling into Bottomless Pits. There are also Super Bats 
which are likely to pick you up and drop you in some 
random room. 


The program asks various questions which you answer 
one per line; it will give a more detailed description if 
you want. 


This program is based on one described in People’s 
Computer Company, 2, 2 (November 1973). 


It will never replace Adventure. 


INTRO(7) 


NAME 
intro — introduction to special files 
SYNOPSIS 
#include <sys/socket.h> 
/* internetworking only */ 
#include <net/route.h> 
#include <net/if.h> 
DESCRIPTION 
This section describes various special files that refer to 
specific hardware peripherals and CTIX System device 
drivers. The names of the entries are generally derived 
from names for the hardware, as opposed to the names of 
the special files themselves. Characteristics of both the 
hardware device and the corresponding CTIX system 
device driver are discussed where applicable. 
INTERNETWORKING 


5/86 


Entries that describe network protocol use are marked 
(7N). These protocols are available only with a special 
version of the CTIX. kernel that supports 
internetworking. For further information, see the CTLX 
Inernetworking Manual. 


All network protocols are associated with a specific 
protocol-family. A protocol-famtly provides _ basic 
services to the protocol implementation to allow it to 
function within a specific network environment. These 
services may include packet fragmentation and 
reassembly, routing, addressing, and basic transport. A 
protocol-family may support multiple methods of 
addressing, though the current protocol implementations 
do not. A protocol-family is normally comprised of a 
number of protocols, one per socket(2N) type. It is not 
required that a protocol-family support all socket types. 
A protocol-family may contain multiple protocols 
supporting the same socket abstraction. 


A protocol supports one of the socket abstractions 
detailed in socket(2N). A specific protocol may be 
accessed either by creating a socket of the appropriate 
type and protocol-family, or by requesting the protocol 
explicitly when creating a socket. Protocols normally 
accept only one type of address format, usually 
determined by the addressing structure inherent in the 
design of the protocol-family/network architecture. 
Certain semantics of the basic socket abstractions are 
protocol specific. All protocols are expected to support 
the basic model for their particular socket type, but 
may, in addition, provide non-standard facilities or 
extensions to a mechanism. For example, a protocol 


ie 
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supporting the SOCK_STREAM abstraction may allow 
more than one byte of out-of-band data to be 
transmitted per out-of-band message. 


A network interface is similar to a device interface. 
Network interfaces comprise the lowest layer of the 
networking subsystem, interacting with the actual 
transport hardware. An interface may support one or 
more protocol families and/or address formats. The 
SYNOPSIS section of each network interface entry gives 
a sample specification of the related drivers for use in 
providing a system description to the config(1M) 
program. The DIAGNOSTICS section lists messages 
which may appear on the console and in the system error 
log /usr/adm/messages due to errors in device 
operation. 


PROTOCOLS 


The system currently supports only the DARPA Internet 
protocols fully. Raw socket interfaces are provided to IP 
protocol layer of the DARPA Internet, to the IMP link 
layer 1822) and to Xerox PUP-1 layer operating on top 
of 3Mb/s Ethernet interfaces. Consult the appropriate 
manual pages in this section for more information 
regarding the support for each protocol family. 


ADDRESSING 


Associated with each protocol family is an address 
format. The following address format is supported: 


#define AF_INET 2 
/* internetwork: UDP, TCP, etc. */ 


ROUTING 
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The network facilities provide limited packet routing. A 
simple set of data structures comprise a “‘routing table”’ 
used in selecting the appropriate network interface when 
transmitting packets. This table contains a single entry 
for each route to a specific network or host. A user 
process, the routing demon, maintains this data base 
with the aid of two socket specific toctl(2) commands, 
SIOCADDRT and SIOCDELRT. The commands allow 
the addition and deletion of a single routing table entry, 
respectively. Routing table manipulations may only be 
carried out by the superuser. 


A routing table entry has the following form, as defined 
in <net/route.h>: 
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struct rtentry { 
u_long rt_hash; 
struct sockaddr rt_dst; 


struct sockaddr rt_gateway; 
short rt_flags; 

short rt_refcnt; 

u_long rt_use; 

struct ifnet *rt_ifp; 


} 
with rt_flags defined from, 
#define RTF_UP 0x1 


* route usable */ 
#define RTF_GATEWAY 0x2 
* destination is a gateway */ 
#define RTF_HOST 0x4 
/* host entry (net otherwise) */ 


Routing table entries come in three types: for a specific 
host, for all hosts on a specific network, for any 
destination not matched by entries of the first two types 
(a wildcard route). When the system is booted, each 
network interface that is autoconfigured installs a 
routing table entry when it wishes to have packets sent 
through it. Normally the interface specifies the route 
through it is a “direct”? connection to the destination 
host or network. If the route is direct, the transport 
layer of a protocol family usually requests the packet be 
sent to the same host specified in the packet. Otherwise, 
the interface may be requested to address the packet to 
an entity different from the eventual recipient (i-e., the 
packet is forwarded). 


Routing table entries installed by a user process may not 
specify the hash, reference count, use, or interface fields; 
these are filled in by the routing routines. If a route is 
in use when it is deleted (rt_refent is nonzero), the 
resources associated with it will not be reclaimed until 
further references to it are released. 


The routing code returns EEXIST if requested to 
duplicate an existing entry, ESRCH if requested to delete 
a nhonexistant entry, or ENOBUFS if insufficient 
resources were available to install a new route. 


User processes read the routing tables through the 
Pace cmon device. 


The rt_use field contains the number of packets sent 
along the route. This value is used to select among 
multiple routes to the same destination. When multiple 
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routes to the same destination exist, the least used route 
is selected. 


A wildcard routing entry is specified with a zero 
destination address value. Wildcard routes are used only 
when the system fails to find a route to the destination 
host and network. The combination of wildcard routes 
and routing redirects can provide an _ economical 
mechanism for routing traffic. 


INTERFACES 
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Each network interface in a system corresponds to a 
path through which messages may be sent and received. 
A network interface usually has a hardware device 
associated with it. 


At boot time each interface which has underlying 
hardware support makes itself known to the system 
during the autoconfiguration process. Once the interface 
has acquired its address, it is expected to install a 
routing table entry so that messages may be routed 
through it. Most interfaces require some part of their 
address specified with an SIOCSIFADDR ioctl before 
they will allow traffic to flow through them. On 
interfaces where the network-link layer address mapping 
is static, only the network number is taken from the 
ioctl; the remainder is found in a hardware-specific 
manner. On interfaces which provide dynamic network- 
link layer address mapping facilities (e.g. 10Mb/s 
Ethernets), the entire address specified in the ioctl is 
used. 


The following toctl calls may be used to manipulate 
network interfaces. Unless specified otherwise, the 
request takes an tfrequest structure as its parameter. 
This structure has the form 


struct ifreq { 
char —_ifr_name(16]; 
/* name of interface (e.g. "ec0”) */ 
union { 
struct sockaddr ifru_addr; 
struct sockaddr ifru_dstaddr; 
short _ifru_flags; 
ifr_ifru; 
#define ifr_addrifr_ifru.ifru_addr 
ves address */ 
#define ifr_dstaddr ifr_ifru.ifru_dstaddr 
/* other end of p-to-p link */ 
#define ifr_flagsifr_ifru.ifru_flags 
/* flags */ 
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SIOCSIFADDR 
Set interface address. Following the address 
assignment, the “‘initialization” routine for the 
interface is called. 


SIOCGIFADDR 


Get interface address. 


SIOCSIFDSTADDR 


Set point-to-point address for interface. 


SIOCGIFDSTADDR 
Get point-to-point address for interface. 


SIOCSIFFLAGS 
Set interface flags field. If the interface is 
marked down, any processes currently routing 
packets through the interface are notified. 


SIOCGIFFLAGS 
Get interface flags. 


SIOCGIFCONF 
Get interface configuration list. This request 
takes an tfconf structure (see below) as a value- 
result parameter. The tfe_len field should be 
initially set to the size of the buffer pointed to 
by tfe_buf. On return it will contain the length, 
in bytes, of the configuration list. 
* 


* Structure used in SIOCGIFCONF request. 
* Used to retrieve interface configuration 

* for machine ate for programs which 

: must know ali networks accessible). 


struct ifconf { 
int ifc_len; 
/* size of associated buffer */ 
union { 
caddr_t ifcu_buf; 
struct  ifreq *ifcu_req; 
ife_ifcu; 
#define ifc_buf ifc_ifcu.ifcu_buf 
/* buffer address */ 
#define ifc_req ifc_ifcu.ifeu_req 
; * array of structures returned */ 


SEE ALSO 


config(1M), iocti(2), socket(2N), intro(7). 


NAME 


CONSOLE(7) 


console — console terminal 


DESCRIPTION 
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The special file /dev/console designates a standard 
destination for system diagnostics. The kernel writes its 
diagnostics to this file, as does any user process with 
messages of systemwide importance. Unless CTIX is 
configured with the kernel debugger, console is not 
associated with a terminal; console messages are written 
to /etc/log/confile. If console is associated with a 
physical terminal (configured with the kernel debugger), 
then console messages appear on that terminal. 


Note that intttab(4) does not normally post a getty on 
console because it has no source for interactive input. 


Console messages are saved in a circular buffer. Reading 
console retrieves the messages and removes them from 
the buffer. 


If CTIX is configured with the kernel debugger (see 
config(1M)), then tty000 is associated with the console. 
This means that console messages also go to tty000 and 
that a Control-B on tty000 starts the kernel debugger. 


The size of the console circular buffer is configured with 
the config(1M) parameter cbufsz. The default is 4096 
bytes. 


The following ioctl(2) commands are acceptd: 


ioctl(fd, CONERR); 
Fd must be open to console. All console output 
is to be duplicated in the error message queue. 
See err (7). 


ioctl(fd, CONBUF); 
Fd must be open to console. No console output 
is to be duplicated in the error message queue. 
This is the initial condition. 


ioctl(fd, CON_SET, port) 
Fd must be open to console. Port is the minor 
device number of the RS-232 line that will be 
the new debugger console; port must be a valid 
RS-232 channel. The function returns the 
number of the new debugger console port. 
ioctl(fd, CON_LOC) 
Fd must be open to console. The function 
returns the number of the current debugger 
console port. 
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FILES 
/dev/console 
/etc /log/confile 
SEE ALSO 
conlocate(1M), syslocal(2). 
WARNING 
Normal system processing is suspended while the kernel 
debugger is active. 
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NAME 
disk — general disk driver 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/gdisk.h> 
#include <sys/gdioctl.h> 


DESCRIPTION 
The files 
/ dev /rdsk/c0d0s0 
through 
/dev /rdsk/czdzsz 
d 


an 

/ dev /dsk/cO0d0s0 

through 

/dev/dsk/ezdzsz 

refer to CTIX device names and slices, where cz is the 
controller number, dz is the drive number, sz is the slice 
number, and z is a hexadecimal digit. An r in the 
name indicates the character (raw) interface, 


MightyFrame and MiniFrame format a disk with 512- 
byte physical sectors. Winchester disks have 17 physical 
sectors per track. SMD drives have 33 to 65 physical 
sectors per track. 


Block input/output uses 1024-byte logical blocks. 
Winchester disks have 8 logical blocks on each track, 
with the leftover physical block available as an alternate 
for a bad block. SMD disks have 16 to 32 logical blocks 
on each track, with the leftover physical block available 
as an alternate for a bad block. 


Logical block zero contains the Volume Home Block, 
which describes the disk. The following structure defines 
the volume home block. 


struct vhbd { 


uint magic; /* Mitiframe disk format code */ 

int chksum; /* adjustment so 32 bit sum starting 
from magic for 1K bytes sums to —1 */ 

struct gdswprt dsk; /* specific description of this disk */ 

struct partit partab[MAXSLICE];/* partition table */ 

struct resdes{ /* reserved area special files */ 


daddr_t blkstart; /* start logical block # */ 
ushort nblocks; /* length in logical blocks 
(zero implies not present) */ 


} resmap|8}; 
/* resmap consists of the following entries: 
* loader area 
. bad block table 
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dump area 


+ *& & 


*/ 
char fpulled; 
long time; 
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down load image file 
Bootable program, 
size determined by a.out format. nblocks=1. 


/* dismounted last time? */ 
/* time last came on line */ 


struct gdswprt2 dsk2; /* Drive specific parameters */ 


char minires([38]; 


char sysres[292]; 


/* for future mini/miti frame 
enhancements */ 
/* custom system area */ 


struct mntnam mntname|MAXSLICE]; 


char _ userres[256]; 


}; 


struct gdswprt { 
char name|6]; 
ushort cyls; 
ushort heads; 
ushort psectrk; 
ushort pseccyl; 


char flags; 
char step; 
ushort sectorsz; 


}; 


struct gdswprt2 { 
short wpccyl; 


ushort enetaddr(3}; 


unchar gapl; 
unchar gap2; 
char _ filler{28]; 


’ 


struct partit{ 
union { 
uint strk; 
struct { 


/* names for auto mounting; null 
* string means no auto mount 

* not used in mitiframe */ 

/* user area */ 


/* printf name */ 
/* the number of cylinders for this disk */ 
/* number of heads per cylinder */ 
/* number of physical sectors per track */ 
/* number of physical sectors per cylinder */ 
/* floppy density and high tech drive flags */ 
/* stepper motor rate to controller - 

ST506 only */ 
/* size of physical sectors (in bytes) */ 


/* value to program for RWC/WPC - 
ST506 only */ 

/* Ethernet station address - 

* MiniFrame only */ 

/* Gap size on SMD drives */ 


/* start track number (new style) */ 


ushort strk; /* start track # */ 
ushort nsecs; /* # logical blocks available to user */ 


} old; 
} sz; 
}; 
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If a volume home block is valid, magic is equal to 
VHBMAGIC and the 32-bit sum of the volume home 
block’s bytes is OxFFFFFFFF (-1); chksum is the 
adjustment that makes the sum come out right. 


Dsk describes the peculiarities of the disk, including 
deliberate deviations from the system standard. 
Dsk.flags the bitwise or of zero or more of the following 
constants: 


FPDENSITY (MiniFrame only) If on, the 
disk is double density; if 
off, the disk is single 
density. 

FPMIXDENS (MiniFrame only) If off, 
FPDENSITY specifies the 
density of the first track; if 
on, the first track is single 


density regardless of 
FPDENSITY. 
HITECH (ST506 only) If on, head 


select bit 3 is valid; if off, 
reduced write current is 
valid. 


NEWPARTTAB If off, the old style slice 
(partition) table is in use; if 
on, the new style slice table 


is in use. 

RWCPWC (ST506 only) If on, set 
reduced write current/write 
precompensation. 
HITECH selects’ write 
precompensation. 

EXCHANGEABLE If on, the disk is a floppy 


or removable hard disk 
cartridge. If off, the disk is 
a winchester. 


FORMATEXTRA If on, the SMD drive is 
formatted with an extra 
sector on each track. (This 
sector is ignored by CTIX 
but is required for some 
disk drives, notably the 
Eagle-XP.) 


Dsk.step specifies a stepper motor rate for the ST506; 
use 14 in this field. 
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Partab divides the disk into slices (partitions). 


Fpulled indicates whether an exchangeable disk was 
properly removed from the drive. The system sets this 
field to 1 when the disk is inserted in the drive. To clear 
fpulled, run dismount(1M); see that entry. 


Mntname, minires, and userres are reserved for future 
use. 


Resmap describes the files that share Slice 0 with the 
Volume Home Block. Provision is made for eight such 
files, but only five have been assigned slots in resmap. 
Each resmap entry gives the starting location (logical 
block number) and length (logical blocks). A length of 
zero indicates that the file is not provided. The first five 
entries in resmap describe: 


1. The loader. When the system is reset or turned 
on, the boot prom loads the loader into the 
loader address and jumps execution to it. The 
function of the loader is to search for and load a 
program that will boot the system. 


On MightyFrame the loader searches the tape, 
onboard Winchester disks 0, 1, and 2, and the 
VME, in that order. On MiniFrame the loader 
searches the tape, the floppy disk, and 
Winchester disks 1 and 0, in that order. 


On each disk, the loader first checks for a 
standalone program. If the disk lacks a 
standalone program, the loader checks for a 
CTIX kernel, which must be a CTIX executable 
object file called /unix in the file system in slice 
1. When the loader locates an appropriate 
program, it preserves the crash dump table, 
loads the program it found at the address it was 
linked at (0x0 if unknown) and executes it. If no 
disk contains an appropriate file, the loader 
continues searching until an appropriate disk is 
inserted. 


2. The bad block table, which always begins at 
logical block 1 of the disk. Each logical block in 
the bad block table consists of a four-byte 
checksum followed by 127 bad block cells. The 
checksum is a value that makes the 32-bit sum 
of the logical block be OxFFFFFFFF (-1). A 
bad block cell is defined by the following 


structure. 
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struct bbcell { 
ushort cyl; /* the cylinder of the bad block */ 
ushort badblk; = /* the physical sector address of 
the bad block within the cylinder cyl */ 
ushort altblk; /* track number of alternate */ 
ushort nxtind; /* index into the cell array for next 
bad block cell for this cylinder */ 
}; 
A single sequence of numbers, starting from zero, 
identifies the checksums and cells. In each cell 
in use, cyl identifies a cylinder that contains the 
bad block; badblk physical block offset within 
the cylinder of the bad block; altblk identifies 
the track that contains the alternate block; 
neztind (not used in MightyFrame) identifies the 
next cell for a bad block on the same cylinder or 
is zero if this is the last one. 


The dump area. After Reset or Suicide, the 
Boot prom dumps processor registers, the 
memory map, a crash dump block, and the 
contents of physical memory, until it runs out of 
room in the dump area. 


The down load image area. The down load 
images are described by a table at the beginning 
of the area. The area is described by the 
following array. 


struct dident { 

short d_strt; 

/* block displacement from down load index */ 

short d_sz; 

/* # of blocks for this entry */ 
The image number is the index for dldent. 
D_strt is the offset in bytes of the image from 
the beginning of the down load image area; d_sz 
is the size in bytes of the image. 


A bootable program, usually a diagnostic. This 
is the program the loader considers a substitute 
for the /unix file. The program must be in 
a.out(4) format with magic number 407 or be a 
simple memory image. 


If the fifth entry in resmap has a zero address 
but a nonzero length, the loader looks at the 
beginning of slice 1 for the program. 
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Slice 0 is called the Reserved Area. Only the volume 
home block and the files described by resmap can be in 
the Reserved Area. A formatted disk used by a working 
system certainly has at least one more slice. 


Ioctl system calls use the following structure. 
struct gdioctl { 


ushort status; /* status */ 

struct gdswprt params; /* description of the disk */ 
struct gdswprt2 params2; /* more description of the disk */ 
short ctrityp; /* the type of disk controller */ 


short driveno; 
}: 
Status is the bitwise or of the following constants. 
VALID_VHB- A valid Volume Header Block has been 


read. 
DRV_READY The disk is on line. 
PULLED Last removal of disk from drive was not 


preceded by proper dismount. 


Params is a gdswprt structure, the same type used in the 
volume header block. 


Dsktype is equal to 
GD_WD1010 for Western Digital 1010 ST506 


Controller 

GD_WD2010 for Western Digital 2010 ST506 
Controller 

GD_WD2797 for Western Digital 2797 Floppy Disk 
Controller 


GD_RAMDISK for RAM Disk Emulator 
GD_SMD3200 for Interphase SMD3200 disk controller 
CTIX understands the following disk toctl calls. 
ioctl(fd, GDIOCTYPE, 0) 
Returns GDIOC if fd is a file descriptor for a 
disk special file. 
ioctl(fd, GDGETA, gdctl_ptr) 
Gdctl_ptr is a pointer to a gdtoctl structure. 


Toctl fills the structure with information about 
the disk. 


ioctl(fd, GDSETA, gdctl_ptr) 
Gdctl_ptr is a pointer to a gdtoctl structure. 
Toctl passes the description of the disk to the 
disk driver. This is primarily meant for reading 
disks created by other kinds of computers. 
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ioctl(fd, GDFORMAT, ptr) 


Ptr points to formating information. The disk 
driver formats a track. 


ioctl(fd, GDDISMNT) 


SEE ALSO 


Toctl informs the driver that the user intends to 
remove the disk from the drive. When this 
system call successfully returns, the driver has 
flushed all data in the buffer cache and waited 
for all queued transfers to complete. The last 
transfer is to write out the Volume Home Block 
with the fpulled flag cleared. Once this call 
returns the drive is inaccessible until a new disk 
is inserted. 


iv(1), mknod(1M), ioctl(2). 
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drivers — loadable device drivers 


DESCRIPTION 


A loadable driver is equivalent to a fixed, linked-in 
device driver. It has access to all kernel subroutines and 
global data. After it is loaded, it is effectively part of 
the running kernel. 


Differences between loadable and ordinary drivers 
involve their driver ID, init routine, release routine, and 
interrupt processing. 


Init Routine 


Loadable drivers may have an init routine that is 
executed when the driver is bound, and a release routine 
that is executed when the driver is unbound (see 
Iddrv(1M) for a description of driver allocation and bind 
operations). Init routines check for the existence of 
hardware, initialize the hardware, put the interrupt 
service routine for the hardware into the interrupt chain, 
and do other similar tasks. 


Release Routine 


Release routines make sure the device or driver is idle, 
turn off the device, take the interrupt service routine out 
of the interrupt chain, and similar tasks. A typical action 
for a release routine to take when the device 18 not idle is 
to set an error code in u.u_error and return. 


Driver ID 


All drivers have a driver ID. Preloaded drivers have a 
driver ID of 0. Loaded drivers are given an ID when 
they allocate virtual space. The driver ID is 
automatically set when the driver is linked. The ID 
should never be modified by the driver itself; the ID is 
used to identify the driver to the system when making 
certain requests. 


EXAMPLE 


/* init, release, interrupt service routines */ 
/* for loadable device xyzzy */ 


#include <sys/drv.h> 


#define XYZ_VECNO 0x60 /* interrupt vector number */ 
#define XYZ_BUSY 1 /* flags */ 

#define XYZ_OPEN 2 

int xyzzint(); /* interrupt service routine */ 
extern int DFLT_ID; 

static int Drv_id = &DFLT_ID; /* set drive ID */ 

int xy_base; 

int xy_flags; 
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xy_init() 
if (set_vec(Drv_id, XYZ_VECNO, xyzzyint) < 0) 


u.u_error = EBUSY; 
return; 


<do hardware initialization > 


xy_release() 


{ 
if (xy_flags & (XY_BUSY | XY_OPEN)) 
u.u_error = EBUSY; 
return; 
} 
<turn off device> 
reset_vee (Drv_id, XYZ_VECNO); 
} 
xyzzyint() 
<clear interrupt > 
< process interrupt > 
} 
SEE ALSO 


Writing MightyFrame Device Drivers. 
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NAME 


ERR (7) 


err — error-logging interface 


DESCRIPTION 


FILES 


Minor device 0 of the err driver is the interface between 
a process and the system’s error-record collection 
routines. The driver may be opened only for reading by 
a single process with super-user permissions. Each read 
causes an entire error record to be retrieved and 
removed; the record is truncated if the read request is for 
less than the record’s length. 


An appropriate command to the console sends console 
information to the error record queue. See console(7). 


/dev/error special file 


SEE ALSO 


errdemon(1M), console(7). 


NAME 
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Ip — parallel printer interface 


DESCRIPTION 


Lp is an interface to the parallel printer channel. Bytes 
written are sent to the printer. Opening and closing 
roduce page ejects. nlike the serial interfaces 
terméo(T)), the Ip driver never prepends a carriage 
return to a new line (line feed). The /p driver does have 
options to filter output, for the benefit of printers with 
special requirement. The driver also controls page 
format. Page format and filter options are controlled 
with toctl(2): 


#include <sys/Iprio.h> 
loctl(fildes, command, arg) 


where command is one of the following constants: 


LPRGET Get the current page format and put it 
in the Iprio structure pointed to by 
arg. 

LPRSET Set the current page format from the 


location pointed to by arg; this location 
is a structure of type Iprio, declared in 
the header file: 


struct Iprio { 
short ind; 
short col, 
short line; 
Arg should be declared as follows: 
struct lprio *arg; 


Ind is the page indent in columns, 
initially 4. Col is the number of 
columns in a line, initially 132, Line is 
the number lines on a page, initially 66. 
A newline that extends over the end of 
a page is output as a formfeed. Lines 
longer than the line length minus the 
indent are truncated. 


LPRSOPTS 
Constant Value 
LPNOBS 4 
LPRAW 8 
LPCAP 16 
LPNOCR 32 
LPNOFF 64 
LPNONL 128 
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Set the filter options from arg, which 
must be of type int. Arg should be the 
logical or of one or more of the 
following constants, defined in the 
header file: 

Meaning 


No back space. Set this bit if the 
printer cannot properly _ interpret 
backspace characters. The driver uses 
carriage return to produce equivalent 
overstriking. 


Raw output. Set this bit if the driver 
must not edit output in any way. The 
driver ignores all other option bits. 


Capitals. This option supports printers 

with a ‘“‘half-ASCII’’ character set. 

Lowercase is translated to uppercase. 

The following special characters are 

translated: { to {, } to }; * to -; | to 
. to * 


“s 

No Carriage Return. This option 
supports printers that do not respond to 
a carriage return (character OD 
hexadecimal). Carriage returns are 
changed to newlines. If No Newline is 
also set, carriage returns are changed to 
form feeds. 


No Form Feed. This option supports 
printers that do not respond to a form 
feed (character OC hexadecimal). Form 
Feeds are changed to newlines. If No 
Newline is also set, form feeds are 
changed to carriage returns. 


No Newline. This option supports 
printers that do not respond to a 
newline (character OA hexadecimal). 
Newlines are changed to carriage 
returns. If No Carriage Return is also 
set, newlines are changed to form feeds. 


Setting all three of No Carriage Return, No New Line, 
and No Form Feed has the same effect as setting none of 


them. 


LPRGOPTS 


Return the current state of the filter 
options. 
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Note that once set, options will remain intact through a 
close. 
FILES 
/dev/lp? 
SEE ALSO 
Ipr(1), Ipset(1). 
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NAME 
mem, kmem — system memory interface 


DESCRIPTION 
Mem is a special file that is an image of the system 
memory. It may be used, for example, to examine, and 
even to patch the system. 


Byte addresses in mem are interpreted as memory 
addresses. References to non-existent locations cause 
errors to be returned. 


Examining and patching device registers is likely to lead 
to unexpected results when read-only or write-only bits 
are present. 


The file kmem is the same as mem except that kernel 
virtual memory rather than physical memory is accessed. 


On the MightyFrame system accessing 0 to 24 megabytes 
allows a process to read its own space. Ox7F800000 to 
0x80000000 allows a process to read the kernel. 
Nonvalid pages cause errors to be returned. 


SEE ALSO 
vme(7). 
FILES 
/dev/mem 
/dev/kmem 
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NAME 
null — the null file 


_ DESCRIPTION 
Data written on a null special file is discarded. 


Reads from a null special file always return 0 bytes. 


FILES 
/dev/null 


NAME 


PRF (7) 


prf — operating system profiler 


DESCRIPTION 


FILES 


The file prf provides access to activity information in 
the operating system. Writing the file loads the 
measurement facility with text addresses to be 
monitored. Reading the file returns these addresses and 
a set of counters indicative of activity between adjacent 
text addresses. 


The recording mechanism is driven by the system clock 
and samples the program counter at line frequency. 
Samples that catch the operating system are matched 
against the stored text addresses and increment 
corresponding counters for later processing. 


The file prf is a pseudo-device with no associated 
hardware. 


/dev/prf 


SEE ALSO 


config(1M), profiler(1M). 


NAME 


Qic(7) 


qic — interface for QIC tape 


DESCRIPTION 


This interface provides access to quarter-inch streaming 
tape (QIC). QIC tape drives are supported only as 
character devices. If the system has a default tape 
device (such as the QIC on a MightyFrame system), the 
rmtO and rmt4 devices exist and are linked to the 
appropriate real device names. To get the raw, rewind 
on close device, use rmt0. To get the raw, no-rewind on 
close device, use rmt4. 


Tape files are separated by tape marks, also known as 
EOFs. Closing a file open for writing writes one tape 
mark; if the device was no-rewind, the tape is left 
positioned just after the single QIC tape mark. Note 
that it is not possible to overwrite a tape mark. Writing 
must begin either at the beginning of the tape or after 
any previously recorded data. 


Each read or write reads or writes the next physical 
block. A read must match the size of a normal tape 
block. The size of a write determines the size of the next 
block; Write sizes must be a multiple of 512. 
Read/write buffers must begin on an even address; this 
is the same alignment as short. Seeks are ignored. 
Reading a tape mark produces a zero-length read and 
leaves the tape positioned after the mark; the program 
can, without closing the device, read the next tape file. 


The following commands are supported for QIC tape via 
toctl(2): 


#include <sys/tsioctl.h> 
ioctl (fildes, cmd, arg) 


where cmd is one of the following: 
TPGETA Get the current status of the tape 


controller. Arg must be a pointer to a 
tpto struction defined as follows: 


struct tpio { 
unsigned status; 
} short under; 
TPCMD Specify a command to the tape 
controller as specified in arg. The 
following are legal values of arg: 


TPIOCTYPE 


FILES 
/dev/rmt? 
/dev/rqic/* 
WARNING 
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SENSE Perform a read tape status. 
The result may be read via 
TPGETA. 


TRESET Reset the tape controller. 


REWIND 
Issue a rewind command. 
ERASE Issue an erase tape command. 
RETEN Issue a_i retension tape 
command. 


Return TPIOC if fildes is a file 
descriptor for a tape special file. 


A nondata error cannot be recovered from except by 
closing the device. 


A QIC tape has no special mark for end of tape, as 
opposed to end of file. 
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NAME 
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sxt — pseudo-device driver 


DESCRIPTION 


Szt is a pseudo-device driver that interposes a discipline 
between the standard tty line disciplines and a real 
device driver. The standard disciplines manipulate 
virtual tty structures (channels) declared by the sat 
driver. Szt acts as a discipline manipulating a real tty 
structure declared by a real device driver. The szt driver 
is currently only used by the shi (1) command. 


Virtual ttys are named by inodes in the subdirectory 
/ dev /sxt and are allocated in groups of up to eight. To 
allocate a group, a program should exclusively open a file 
with a name of the form /dev/sxt/??0 (channel 0) and 
then execute a SXTIOCLINK toctl call to initiate the 
multiplexing. 


Only one channel, the controlling channel, can receive 
input from the keyboard at a time; others attempting to 
read will be blocked. 


There are two groups of toctl(2) commands supported by 
szt. The first group contains the standard ioctl 
commands described in termto(7), with the addition of 
the following: 


TIOCEXCL Set exclusive use mode: no further opens are 

permitted until the file has been closed. 

TIOCNXCL Reset ezclustve use mode: further opens are 

once again permitted. 

The second group are directives to szt itself. Some of 

these may only be executed on channel 0. 

SXTIOCLINK — Allocate a channel group and multiplex 
the virtual ttys onto the real tty. The 
argument is the number of channels to 
allocate. This command may only be 
executed on channel 0. Possible errors 
include: 

EINVAL The argument is out of 
range. 


ENOTTY The command was not 
issued from a real tty. 


ENXIO linesw is not configured 
with szt. 


EBUSY An SXTIOCLINK 
command has _ already 
been issued for this real 


FILES 


SEE ALSO 
shl(1), stty(1), ioctl(2), open(2), termio(7). 


SXTIOCSWTCH 


SXTIOCWF 


SXTIOCUBLK 


SXTIOCSTAT 


SXTIOCTRACE 


SXTIOCNOTRACE 


/dev/sxt/??[0-7] 
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tty. 


ENOMEM There is no system 
memory available for 
allocating the virtual tty 
structures. 


EBADF Channel O- was _ not 
opened before this call. 


Set the controlling channel. Possible 
errors include: 


EINVAL An invalid channel 
number was given. 


EPERM The command was not 
executed from channel 0. 


Cause a channel to wait until it is 
the controlling channel. This 
command will return the error, 
EINVAL, if an invalid channel 
number is given. 


Turn off the loblk control flag in the 
virtual tty of the indicated channel. 
The error EINVAL will be returned 
if an invalid number or channel 0 is 
given. 


Get the status (blocked on input or 
output) of each channel and store in 
the sztblock structure referenced by 
the argument. The error EFAULT 
will be returned if the structure 
cannot be written. 


Enable tracing. Tracing information 
is written to / devi oon This 
command has no effect if tracing is 
not configured. 


Disable tracing. This command has 
no effect if tracing is not configured. 


Virtual tty devices 


/usr/include/sys/sxt.h Driver specific definitions. 


— 


NAME 
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termio — general terminal interface 


DESCRIPTION 


CTIX systems use a single interface convention for all 
RS-232 and cluster (RS-422) terminals, although cluster 
terminals do not use all the features of the convention. 
The convention is almost completely taken from the 
UNIX System V interface for asynchronous terminals. 


Three kinds of terminals use this convention: 


e RS-232 terminals connected to channels on the 
MightyFrame or MiniFrame itself. 
e Cluster terminals. Generally a cluster channel 


supports more than one terminal and some 
terminals are indirectly connected through other 
(daisy-chained) terminals. Cluster terminals use 
the same interface as directly connected RS-232 
terminals, except that hardware control 
operations are meaningless on cluster terminals. 
(Note that ‘cluster terminal”’ refers to the way 
the terminal is used, not to the terminal itself; a 
Convergent Technologies terminal can serve as 
an RS-232 terminal or as a cluster terminal.) 


° Local RS-232 terminals. These are connected to 
RS-232 channels on cluster terminals. They 
actually use the cluster terminal’s RS-422 
channel to communicate with the host computer 
system, but work like regular RS-232 terminals. 


A single naming convention applies to regular RS-232 
and cluster terminals; a second, related, convention 
applies to local RS-232 terminals. A direct RS-232 or 
cluster terminal has a name of the form /dev/ttyzzz, 
where zzz is the terminal’s number expressed in three 
digits. A local RS-232 terminal has a name of the form 
/dev/tp/carzz where ¢ is the RS-232 channel number (a 
or b), and zzz is the accomodating cluster terminal’s 
terminal number expressed in three digits. A local RS- 
232 terminal cannot be opened prior to the first open on 
the associated RS-422 terminal since the last reboot of 
the system. 


When a terminal file is opened, it normally causes the 
process to wait until a connection is established. In 
practice, users’ programs seldom open these files; they 
are opened by getty and become a user’s standard input, 
output, and error files. The very first terminal file 
opened by the process group leader of a terminal file not 
already associated with a process group becomes the 
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control terminal for that process group. The control 
terminal plays a special role in handling quit and 
interrupt signals, as discussed below. The control 
terminal is inherited by a child process during a fork(2). 
A process can break this association by changing its 
process group using setpgrp(2). 


A terminal associated with one of these files ordinarily 
operates in full-duplex mode. Characters may be typed 
at any time, even while output is occurring, and are only 
lost when the system’s character input buffers become 
completely full, which is rare, or when the user has 
accumulated the maximum allowed number of input 
characters that have not yet been read by some program. 
Currently, this limit is 256 characters. When the input 
limit is reached, all the saved characters are thrown 
away without notice. 


Normally, terminal input is processed in units of lines. 
A line is delimited by a newline (ASCII LF) character, an 
end-of-file (ASCII EOT) character, or an end-of-line 
character. This means that a program attempting to 
read will be suspended until an entire line has been 
typed. Also, no matter how many characters are 
requested in the read call, at most one line will be 
returned. It is not, however, necessary to read a whole 
line at once; any number of characters may be requested 
in a read, even one, without losing information. 


During input, erase and kill processing is normally done. 
By default, the character generated by a Programmable 
Terminal BACK SPACE key (ASCII BS, Control-H on 
most terminals) erases the last character typed, except 
that it will not erase beyond the beginning of the line. 
By default, the character @ kills (deletes) the entire 
input line, and optionally outputs a newline character. 
Both these characters operate on a key-stroke basis, 
independently of any backspacing or tabbing that may 
have been done. Both the erase and kill characters may 
be entered literally by preceding them with the escape 
character (\). In this case the escape character is not 
read. The erase and kill characters may be changed. 


Certain characters have special functions on input. 
These functions and their default character values are 
summarized as follows: 

INTR Rubout or ASCII DEL; generated by a 
rogrammable Terminal DELETE key) 
generates an interrupt signal which is sent to 
all processes with the associated control 
terminal. Normally, each such process is 
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QUIT 


SWTCH 


ERASE 


KILL 


EOF 


NL 
EOL 


STOP 


START 
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forced to terminate, but arrangements may be 
made either to ignore the signal or to receive a 
trap to an agreed-upon location; see signal(2). 


Control-| or ASCII FS; generated by a 
rogrammable Terminal CODE-CANCEL key) 
generates a qutt signal. Its treatment is 
identical to the interrupt signal except that, 
unless a receiving process has made other 
arrangements, it will not only be terminated 
but a core image file (called core) will be 
created in the current working directory. 


ASCII NUL is used by the job control facility, 
shl, to change the current layer to the control 
layer. 


Control-h or ASCII BS; generated by a 
rogrammable Terminal BACKSPACE key) 
erases the preceding character. It will not 
erase beyond the start of a line, as delimited 
by a NL, EOF, or EOL character. 


(@) deletes the entire line, as delimited by a 
NL, EOF, or EOL character. 


Control-d or ASCII EOT; generated by a 
rogrammable Terminal FINISH key) may be 
used to generate an end-of-file from a terminal. 
When received, all the characters waiting to be 
read are immediately passed to the program, 
without waiting for a newline, and the EOF is 
discarded. Thus, if there are no characters 
waiting, which is to say the EOF occurred at 
the beginning of a line, zero characters will be 
passed back, which is the standard end-of-file 
indication. 
(ASCII LF) is the normal line delimiter. It can 
not be changed or escaped. 
(ASCII NUL) is an additional line delimiter, like 
NL. It is not normally used. 
(Control-s or ASCII DC3) can be used to 
temporarily suspend output. It is useful with 
CRT terminals to prevent output from 
disappearing before it can be read. While 
output is suspended, STOP characters are 
ignored and not read. 
(Control-q or ASCH DC1) is used to resume 


output which has been suspended by a STOP 
character. While output is not suspended, 
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START characters are ignored and not read. 
The start/stop characters can not be changed 
or escaped. 


The character values for INTR, QUIT, SWTCH, ERASE, 
KILL, EOF, and EOL may be changed to suit individual 
tastes. The ERASE, KILL, and EOF characters may be 
escaped by a preceding \ character, in which case no 
special function is done. 


When the carrier signal from the data-set drops, a 
hangup signal is sent to all processes that have this 
terminal as the control terminal. Unless other 
arrangements have been made, this signal causes the 
processes to terminate. If the hangup signal is ignored, 
any subsequent read returns with an_ end-of-file 
indication. Thus, programs that read a terminal and test 
for end-of-file can terminate appropriately when hung up 
on. 


When one or more characters are written, they are 
transmitted to the terminal as soon as previously-written 
characters have finished typing. Input characters are 
echoed by putting them in the output queue as they 
arrive. If a process produces characters more rapidly 
than they can be typed, it will be suspended when its 
output queue exceeds some limit. When the queue has 
drained down to some threshold, the program is resumed. 


Several toctl(2) system calls apply to terminal files. The 
primary calls use the following structure, defined in 
<termio.h>: 


#define NCC 8 

struct termio J 
unsigned short _—c_iflag; /* input modes */ 
unsigned short c_oflag; /* output modes */ 
unsigned short c_cflag; /* control modes */ 
unsigned short c_Iflag; /* local modes */ 
char i /* line discipline */ 
unsigned char — c_ec[NCC]; 

/* control chars */ 


f 


a 
C1 
= 
i=} 
2 


}; 
The special control characters are defined by the array 


c_ec. The relative positions and initial values for each 
function are as follows: 


0 VINTR- DEL 
1 VQUIT FS 

2 VERASE BS 

3 VKILL @ 

4 VEOF EOT 
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5 VEOL NUL 
6 reserved 
7 VSWTCH NUL 


The c_tflag field describes the basic terminal input 
control: 


IGNBRK 0000001 Ignore break condition. 
BRKINT 0000002 Signal interrupt on break. 


IGNPAR 0000004 Ignore characters with parity 
errors. 


PARMRK 0000010 Mark parity errors. 

INPCK 0000020 Enable input parity check. 

ISTRIP 0000040 Strip character. 

INLCR 0000100 Map NL to CR on input. 

IGNCR 0000200 Ignore CR. 

ICRNL 0000400 Map CR to NL on input. 

IUCLC 0001000 Map upper-case to lower-case on 


input. 
IXON 0002000 Enable start/stop output control. 
IXANY 0004000 Enable any character to restart 
output. 


IXOFF 0010000 Enable start/stop input control. 


If IGNBRK is set, the break condition (a character 
framing error with data all zeros) is ignored, that is, not 
put on the input queue and therefore not read by any 
process. Otherwise if BRKINT is set, the break condition 
will generate an interrupt signal and flush both the input 
and output queues. If IGNPAR is set, characters with 
other framing and parity errors are ignored. 


If PARMRK is set, a character with a framing or parity 
error which is not ignored is read as the three-character 
sequence: 0377, 0, X, where X is the data of the 
character received in error. To avoid ambiguity in this 
case, if ISTRIP is not set, a valid character of 0377 is 
read as 0377, 0377. If PARMRK is not set, a framing or 
parity error which is not ignored is read as the character 
NUL (0). 

If INPCK is set, input parity checking is enabled. If 
INPCK is not set, input parity checking is disabled. This 
allows output parity generation without input parity 
errors. 


If ISTRIP is set, valid input characters are first stripped 
to 7-bits, otherwise all 8-bits are processed. 


See 
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If INLCR is set, a received NL character is translated into 
a CR character. If IGNCR is set, a received CR character 
is ignored (not read). Otherwise if ICRNL is set, a 
received CR character is translated into a NL character. 


If IUCLC is set, a received uppercase alphabetic 
character is translated into the corresponding lower-case 
character. 


If IXON is set, start/stop output control is enabled. A 
received STOP character will suspend output and a 
received START character will restart output. All 
start/stop characters are ignored and not read. If IXANY 
is set, any input character, will restart output which has 
been suspended. 


If IXOFF is set, the system will transmit START/STOP 
characters when the input queue is nearly empty/full. 


The initial input control value is all-bits-clear. 


The c_oflag field specifies the system treatment of 
output: 


OPOST 0000001 Postprocess output. 

OLCUC 0000002 Map lower case to upper on output. 
ONLCR 0000004 Map NL to CR-NL on output. 
OCRNL 0000010 Map CR to NL on output. 
ONOCR 0000020 No CR output at column 0. 
ONLRET 0000040 NL performs CR function. 
OFILL 0000100 Use fill characters for delay. 
OFDEL 0000200 Fill is DEL, else NUL. 

NLDLY 0000400 Select new-line delays: 

NLO 0 

NL1 0000400 

CRDLY 0003000 Select carriage-return delays: 
CRO 0 


CR1 0001000 
CR2 0002000 
CR3 0003000 


TABDLY 0014000 Select horizontal-tab delays: 
TABO 0 


TABI 0004000 
TAB2 0010000 
TAB3 0014000 Expand tabs to spaces. 


BSDLY 0020000 Select backspace delays: 
BSO 0 

BS1 0020000 

VTDLY 0040000 Select vertical-tab delays: 
VTO 0 

VTi 0040000 

FFDLY 0100000 Select form-feed delays: 
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FFO 0 
FF1 0100000 


If OPOST is set, output characters are post-processed as 
indicated by the remaining flags, otherwise characters 
are transmitted without change. 


If OLCUC is set, a lower-case alphabetic character is 
transmitted as the corresponding upper-case character. 
This function is often used in conjunction with IUCLC. 


If ONLCR is set, the NL character is transmitted as the 
CR-NL character pair. If OCRNL is set, the CR character 
is transmitted as the NL character. If ONOCR is set, no 
CR character is transmitted when at column 0 (first 
position). If ONLRET is set, the NL character is assumed 
to do the carriage-return function; the column pointer 
will be set to O and the delays specified for CR will be 
used. Otherwise the NL character is assumed to do just 
the line-feed function; the column pointer will remain 
unchanged. The column pointer is also set to 0 if the CR 
character is actually transmitted. 


The delay bits specify how long transmission stops to 
allow for mechanical or other movement when certain 
characters are sent to the terminal. In all cases a value 
of 0 indicates no delay. If OFILL is set, fill characters 
will be transmitted for delay instead of a timed delay. 
This is useful for high baud rate terminals which need 
only a minimal delay. If OFDEL is set, the fill character 
is DEL, otherwise NUL. 


If a form-feed or vertical-tab delay is specified, it lasts 
for about 2 seconds. 


new-line delay lasts about 0.10 seconds. If ONLRET is 
set, the carriage-return delays are used instead of the 
new-line delays. If OFILL is set, two fill characters will 
be transmitted. 


Carriage-return delay type 1 is dependent on the current 
column position, type 2 is about 0.10 seconds, and type 3 
is about 0.15 seconds. If OFILL is set, delay type 1 
transmits one or two fill characters, and type 2, four fill 
characters. 


Horizontal-tab delay type 1 is dependent on the current 
column position. Type 2 is about 0.10 seconds. Type 3 
specifies that tabs are to be expanded into spaces. If 
OFILL is set, two fill characters will be transmitted for 
any delay. 


Backspace delay lasts about 0.05 seconds. If OFILL is 
set, one fill character will be transmitted. 


Fae (a 


TERMIO (7) 


The actual delays depend on line speed and system load. 
The initial output control value is all bits clear. 


The c_cflag field describes the hardware control of the 
terminal: 


CBAUD 0000017 Baud rate: 

BO OHang up 

B50 000000150 baud 

B75 000000275 baud 

B110 0000003110 baud 

B134 0000004134.5 baud 

B150 0000005150 baud 

B200 0000006200 baud 

B300 0000007300 baud 

B600 0000010600 baud 

B1200 00000111200 baud 

B1800 00000121800 baud 

B2400 00000132400 baud 

B4800 00000144800 baud 

B9600 00000159600 baud 

B19200 000001619200 baud 

B38400 000001738400 baud 
CSIZE 0000060 Character size: 

CS5 05 bits 

CS6 00000206 bits 

CS7 00000407 bits 

CS8 00000608 bits 
CSTOPB 0000100 Send two stop bits, else one. 
CREAD 0000200 Enable receiver. 
PARENB 0000400 Parity enable. 
PARODD 0001000 Odd parity, else even. 
HUPCL 0002000 Hang up on last close. 
CLOCAL 0004000 Local line, else dial-up. 
LOBLK 0010000 Block layer output. 


The CBAUD bits specify the baud rate. The zero baud 
rate, BO, is used to hang up the connection. If BO is 
specified, the data-terminal-ready signal will not be 
asserted. Normally, this will disconnect the line. For 
any particular hardware, impossible speed changes are 
ignored. 

The CSIZE bits specify the character size in bits for both 
transmission and reception. This size does not include 
the parity bit, if any. If CSTOPB is set, two stop bits are 
used, otherwise one stop bit. For example, at 110 baud, 
two stops bits are required. 

If PARENB is set, parity generation and detection is 
enabled and a parity bit is added to each character. If 
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parity is enabled, the PARODD flag specifies odd parity if 
set, otherwise even parity is used. 


If CREAD is set, the receiver is enabled. Otherwise, no 
characters will be received. 


If LOBLK is set, the output of a job control layer will be 
blocked when it is not the current layer. Otherwise the 
output generated by that layer will be multiplexed onto 
the current layer. 


If HUPCL is set, the line will be disconnected when the 
last process with the line open closes it or terminates. 
That is, the data-terminal-ready signal will not be 
asserted. 


If CLOCAL is set, the line is assumed to be a local, direct 
connection with no modem control. Otherwise modem 
control is assumed. 


The initial hardware control value after open is B9600, 
CS8, CREAD, HUPCL. 


The c_Iflag field of the argument structure is used by the 
line discipline to control terminal functions. The basic 
line discipline (0) provides the following: 


ISIG 0000001 Enable signals. 

ICANON 0000002 Canonical input (erase and kill 
processing). 

XCASE 0000004 Canonical upper/lower 
presentation. 

ECHO 0000010 Enable echo. 


ECHOE 0000020 Echo erase character as BS-SP-BS. 
ECHOK 0000040 Echo NL after kill character. 
ECHONL 0000100 Echo NL. 


NOFLSH 0000200 Disable flush after interrupt or 
quit. 


If ISIG is set, each input character is checked against the 
special control characters INTR, SWTCH, and QUIT. If 
an input character matches one of these control 
characters, the function associated with that character is 
performed. If ISIG is not set, no checking is done. Thus 
these special input functions are possible only if ISIG is 
set. These functions may be disabled individually by 
changing the value of the control character to an 
unlikely or impossible value (e.g., 0377). 


If ICANON is set, canonical processing is enabled. This 
enables the erase and kill edit functions, and the 
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assembly of input characters into lines delimited by NL, 
EOF, and EOL. If ICANON is not set, read requests are 
satisfied directly from the input queue. The values of 
VMIN and VTIME control how many and when 
characters will be returned. If both are 0, reads come 
back immediately if no characters are present. If VMIN 
is greater than 0 and VTIME is equal to 0, the read will 
wait until at least VMIN characters have been received. 
If VMIN is equal to 0 and VTIME is greater than 0, the 
read will return after VTIME tenths of a second, 
regardless of whether any characters have been received. 
Note that in this case a read may return 0, which is 
indistinguishable from end-of-file. If VMIN is greater 
than 0 and VTIME is greater than 0, the timeout period 
starts after the first character has been received; thus a 
read will always return greater than or equal to 1. This 
allows fast bursts of input to be read efficiently while 
still allowing single character input. The MIN and TIME 
values are stored in the position for the EOF and EOL 
characters, respectively. The time value represents 
tenths of seconds. 


If XCASE is set, and if ICANON is set, an upper-case 
letter is accepted on input by preceding it with a \ 
character, and is output preceded by a \ character. In 
this mode, the following escape sequences are generated 
on output ’and accepted on input: 


for: use: 
x ? 


\ 
L \" 


(x 


wt example, A is input as \a, \m as \\n, and \N as 
n. 


If ECHO is set, characters are echoed as received. 


When ICANON is set, the following echo functions are 
possible. If ECHO and ECHOE are set, the erase 
character is echoed as ASCII BS SP BS, which will clear 
the last character from a CRT screen. If ECHOE is set 
and ECHO is not set, the erase character is echoed as 
ASCII SP BS. If ECHOK is set, the NL character will be 
echoed after the kill character to emphasize that the line 
will be deleted. Note that an escape character preceding 
the erase or kill character removes any special function. 
If ECHONL is set, the NL character will be echoed even if 
ECHO is not set. This is useful for terminals set to local 
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echo (so-called half duplex). Unless escaped, the EOF 
character is not echoed. Because EOT is the default EOF 
character, this prevents terminals that respond to EOT 
from hanging up. 

If NOFLSH is set, the normal flush of the input and 


output queues associated with the quit, switch, and 
interrupt characters will not be done. 


The initial line-discipline control value is all bits clear. 
The primary foctl(2) system calls have the form: 


ioctl (fildes, command, arg) 
struct termio *arg; 


The commands using this form are: 


TCGETA Get the parameters associated with 
the terminal and store in the 
termto structure referenced by 
arg. 

TCSETA Set the parameters associated with 
the terminal from the structure 
referenced by arg. The change is 
immediate. 


TCSETAW Wait for the output to drain before 
setting the new parameters. This 
form should be used when 
changing parameters that will 
affect output. 

TCSETAF Wait for the output to drain, then 
flush the input queue and set the 
hew parameters. 

Additional toctl(2) calls have the form: 
ioctl (fildes, command, arg) 
int arg; 

The commands using this form are: 


TCSBRK Wait for the output to drain. If 
arg is 0, then send a break (zero 
bits for 0.25 seconds). 

TCXONC Start/stop control. If arg is 0, 
suspend output; if 1, restart 
suspended output; if 2, transmit 
XOFF; if 3, transmit XON. 

TCFLSH If arg is 0, flush the input queue; if 
1, flush the output queue; if 2, 
flush both the input and output 
queues. 
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FILES Jaev/ 
dev/tty* 
/dev/tp/* 

SEE ALSO 
stty(1), fork(2), ioctl(2), setpgrp(2), signal(2), tp(7), 
tty(7). 

WARNING 
The default value for ERASE is backspace rather than 
the historical #. 


BUGS 
Local RS-232 terminals do not currently provide hangup 
(BO), draining, flushing, or delay. 
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NAME 


TIOP(7) 


tiop — terminal accelerator interface 


SYNOPSIS 


#include <sys/tiop.h> 


DESCRIPTION 


The ttop driver provides loading and unloading functions 
for the terminal accelerator. The open of device 
/dev/tiop will fail if either a terminal accelerator board 
1s not present, or if it is already loaded. The only 
allowable function after opening the top device is to 
issue an toctl to download the accelerator. The following 
command is supported via toctl: 


IOPATTACH 


Download the IOP; erg must point to 
an area in the caller’s space where the 
first 4 bytes are a count of the number 
of bytes to be loaded into the 
accelerator. The actual data must 
follow the count field immediately. 
The count bytes are copied into the 
accelerator starting at memory location 
0. After loading, the accelerator is reset 
and begins execution at O in _ its 
memory. After a successful 
IOPATTACH all but two onboard RS- 
232 ports will be controlled by the 
accelerator. 


NAME 


TP(7) 


tp — controlling terminal’s local RS-232 channels 


DESCRIPTION 


The tp devices accesses the RS-232 channels on the 
controlling terminal. The terminal must be a cluster 
terminal configured to permit use of the local RS-232 
channels (see termto(7). Just as /dev/tty permits a 
process to conveniently access its process group’s 
controlling terminal (see ¢ty(7)), /dev/tpa and 
/dev/tpb access the controlling terminal’s RS-232 
channels without reference to the terminal number. This 
is convenient for accessing the user’s local hardware, 
such as a telephone with an RS-232 interface. 


SEE ALSO 


tty(7). 


NAME 


TTY(7) 


tty — controlling terminal interface 


DESCRIPTION 


FILES 


The file /dev/tty is, in each process, a synonym for the 
control terminal associated with the process group of 
that process, if any. It is useful for programs or shell 
sequences that wish to be sure of writing messages on the 
terminal no matter how output has been redirected. It 
can also be used for programs that demand the name of 
a file for output, when typed output is desired and it is 
tiresome to find out what terminal is currently in use. 


If the terminal is under window management, a process 
group is controlled by a specific window and I/O on 
/dev/tty is directed to that window. A terminal can 
control one process group in each window. See 
window(7). 


/dev/tty 
/dev/tty* 


SEE ALSO 


tp(7), window(7). 


NAME 


VME (7) 


vme — VME bus interface 


DESCRIPTION 


Vme files are a set of special files that are images of the 
VME bus. They may be used, for example, to examine, 
and to modify memory and registers on the VME bus. 


Byte addresses in ume are interpreted as memory 
addresses. For a _ read, references to non-existent 
locations cause errors to be returned; for a write, nothing 
is written and no error is returned. 

Examining and patching device registers is likely to lead 
to unexpected results when read-only or write-only bits 
are present. 


The structure for zoctl calls is: 


#define VMGETREG _ (’v’+0 
#define VMSETREG w+] 


struct vmeioctl { 
unchar vm_mreg; 
unchar mv_preg; 
unchar vm_ireg; 


iE 
The standard VME interface EEPROM contents are: 
#define VME_SLOTS 16 


struct vmeeprom { 


/* Make the entire prom checksum to -1 */ 
int checksum; 


/* EEPROM flags (diag /unix) */ 
int flags; 


/* Offset into EEPROM from the start of code */ 
ushort codeoffset; 


/* unused, reserved */ 
char unused/[2]; 


struct { 
/* Board identification for this slot */ 
char type; 
/* reserved for future use */ 


char unused{7]; 
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/* Address of the board; in MightyFrame I/O space */ 
uint address; 


/* Amount of address space taken up by the board */ 
uint length; 


/* Pointer to an optional initialization function */ 
int — (*initfp)(); 
} slots|)VME_SLOTS]; 


/* Reserve the rest for controller code */ 
char drivers[7860]; 


js 


#define VMEE_DIAG 0 /* Diag has cleared/set EEPROM */ 
#define VMEE_LOADED 1 /* unix has loaded driver information */ 


#define VMET_CMC 1 /* CMC Ethernet controller */ 
#define VMET_V3200 2 /* Interphase SMD controller */ 
FILES 

/dev/vme/al6 64K bytes of short address space 

/dev/vme/a24 32M bytes of standard address 
space 

/dev/vme/a32l low 2. gigabytes of extended 
address space 

/dev/vme/a32h high 2 gigabytes of extended 


address space 
/dev/vme/eeprom 8K VME interface EEPROM 


SEE ALSO 
Ideeprom(1M), system(4), mem(7). 
MightyFrame VME Expanston Manual. 
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NAME 


VT(7) 


vt — virtual terminal 


DESCRIPTION 


A virtual terminal provides a terminal-like 
communication channel between two processes. Each 
virtual terminal consists of two devices: a slave device, 
whose name is of the form /dev/ttypzz, where zz is the 
virtual terminal number; and a master device, whose 
name is of the form /dev/vtzz, where zz is the virtual 
terminal number. The slave device responds to system 
calls just like a real terminal (see COO ee that it 
can control interactive programs such as vi. But instead 
of doing actual input/output, reads and writes on the 
slave device are written and read on the corresponding 
master device by another process. A typical use of a 
virtual terminal is to put a network server on the master 
device and login program on the slave. 


The number of virtual terminals must be configured. 


See config(1M). 


The process on the master device can exercise flow 
control on the slave device, much as a real terminal 
would use XON/XOFF to exercise flow control on a 
terminal device. The parameterless tocél(2) TIOCSTOP 
stops output to the slave device as if with an XOFF 
character; the parameterless toctl(2) TIOCSTART restarts 
output, as if with an XON character. 


FILES 
/dev/ttyp?? slave devices 
/dev/vt?? master devices 
SEE ALSO 
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config(1M), ttyname(3C), termio(7). 
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NAME 

window — window management primitives 
SYNOPSIS 

#include <sys/window.h> 
DESCRIPTION 


Window managment (wm(1)) provides a superset of 
windowless terminal features. This entry describes 
terminal file features special to window management. 
Window management features are designed not to 
interfere with programs that do not know about window 
management. Such design includes simple extensions to 
the UNIX System’s standard concepts of file descriptor 
and control terminal. 


e Each terminal file descriptor has an associated 
window number, a small positive integer that 
identifies a window. A window number is the 
most primitive way to refer to a window, and 
should not be confused with the window ID used 
by window management subroutines. A new 
window gets the smallest window number not 
already in use. Closing a window frees its 
number for possible assignment to a later 
window. Output and control calls on the file 
descriptor apply only to the descriptor’s window; 
input calls succeed only when the window is 
active. 


A file descriptor created by a dup(2) or inherited 
across a fork(2) inherits the original descriptor’s 
window number. All the file descriptors in such 
a chain of inheritance, provided they belong to 
processes in the same process group, are affected 
when toctl changes the window number of any of 
them. 


e When a process group’s control terminal is under 
window managment, the process group is 
actually controlled by a particular window. 
Such can have more than one process group, 
each controlled by a different window. 
Keyboard-generated signals (interrupt and quit) 
go to the process group controlled by the active 
window. 


When the user creates a new window by using the SPLIT 
key, the window manager forks a process for that 
window. The new process inherits file descriptors for 
standard input (0), standard output (1), and standard 
error (2) that are associated with the new window. The 
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new process is leader of a process group controlled by the 
new window. The new process also inherits the 
environment of the parent process, which is the window 
manager itself. 


Programs that create and use windows use window 
management toctl(2) calls. Such calls take the form 


ioctl (fildes, command, arg) 
struct wioctl *arg; 


Fildes is a file descriptor for terminal and window 
affected, command is a window management command 

es below) arg is a pointer to the following structure, 
eclared in <sys/window.h>: 


#define NWCC 2 


struct wioctl { 
wndw_t wi_dfltwndw; 
wndw_t wi_wndw; 
slot_t | wi_mycpuslot; 
slot_t wi_destcpuslot; 
port_t wi_bport; 
char wi_dummy; 
} unsigned char wi_ce(NWCC]; 
, 
Window management foctl calls get (WIOCGET) and set 
(WIOCSET and WIOCSETP) terminal attributes described 
in the wtoctl structure: 


wi_dfltwndw The window number for the 
process’s default window. If the 
process does an open on 
/dev/tty, the new _ file 
descriptor is associated with the 
default window. 


wi_wndw The window number for the 
window that fildes (toctl’s first 
parameter) is associated with. 


wi_mycpuslot (This field is required for 
istorical reasons and is not 
meaningful to the host.) 


wi_destcpuslot (This field is required for 
historical reasons; it is not 
meaningful to the host 
processor.) 


wi_bport This field is required for 
istorical reasons; it is not 
meaningful to the host 
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processor.) 


Wwi_c¢c (This field is required for 

historical reasons; it is not 
meaningful to the host 
processor.) Not used by the 
CTIX kernel. A value supplied 
by a WIOCSET or WIOCSETP is 
stored in a place associated with 
window wp_wndw. A 
subsequent WIOCGET on the 
same window retrieves. the 
information. 


Here are the window management toctl commands: 


WIOCGET Get information on calling 
process and file descriptor 
fildes. Fill in arg. 

WIOCSET Set values for calling 
process and file descriptor 
fildes from information in 
arg. Has no effect on 


process group-control 
terminal relationship. 
WIOCSETP Set values for calling 


process and file descriptor 
fildes from information in 
arg. The window specified 
in arg->wt_wndw becomes 
the process’s group’s 
controlling terminal 
provided the following: 


e The calling process 
is the process group 
leader. 


e The process group is 
not currently 
controlled by 
another window on 
this or any other 
terminal. 

e The specified 
window is not 


already a _ control 
window. 


WIOCLRP Only valid executed by process 
group leader. The process group 
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ceases to have a control terminal 
or window and the control 
terminal/window ceases to control 
any process group. The process 
group is free to find another 
control terminal/window, and the 
old control terminal/window is 
free to become the control 
terminal/window for another 
process group. 


WIOCCLUSTER 


Joctl returns 1 if and only if the 
terminal is a cluster terminal. 


WIOCDIRECT Enable direct sending of terminal 


IPC requests. 


WIOCUNDIRECT 


Disable direct sending of terminal 
IPC requests. 


An open on a terminal special file other than / dev /tty 
{for example, /dev/tty000) produces a file descriptor 
or the lowest-numbered open window. Joctl can move 
this file descriptor to any window. 


An open can also obtain a controlling terminal/window. 
The requirements are the same as for WIOCSETP. 


FILES 


/dev/tty — control terminal 
/dev/tty??? — terminals 


SEE ALSO 
stty(1), wm(1), 


dup(2), fork(2), _ioctl(2), Pea 


wmegetid(3X), wmlayout(3X), wmop(3X), wmsetid(3 


termio(7), tty(7). 
WARNINGS 


WIOCDIRECT and WIOCUNDIRECT are required by the 


operating system. 
inadvisable. 


Their use by user programs is 


